HbGitHubNotifyStu

GitHub 邮件提醒配置指南 | 开智学堂

近来很多学员表示被白花花的 GitHub 提醒邮件轰炸得很头疼，比如：

• 群规能不能加一条建议？不要直接在GitHub 回复自己什么时候到，这样所有人都会收到消息。如果有必要请和组织者联系，Github上请发布可能所有人都需要注意的问题。我觉得这和 email 的礼节一样，不要动不动就reply to all。

• 由于 GitHub 绑定了工作邮箱，导致工作邮箱不断收到邮件提醒，影响正常工作邮件。
• 怕错过认知写作班的重要信息，而又不想被过多的信息骚扰。

GitHub 作为开智课程的主题交流、笔记提交&互评、活动发起及报名平台，如何避免被 issues 信息轰炸又不错过课程重要通知，是很多 GitHub 协作新手烦恼的问题。特整理一篇设置指南，供开智学堂学员参考。

在往下看前，建议先用 2 分钟思考一下这个问题：

GitHub 作为全球最大的程序员协作平台，必然有优雅高效的消息提醒机制。但你收件箱不断收到 GitHub Writer002 仓库的消息，白花花一片心烦意乱。为什么你收到的消息提醒方式如此不优雅？

其实只要连问自己 3 个为什么，一般都能找到解决思路：

• 分析
• 推荐方案
  • 效果：
  • 所需条件
  • 配置步骤
    • 一、watching 仓库，但 email 只接收 participating 的通知
    • 二、 配置收信规则过滤邮件
    • 三、将收件方式设为会话模式
• 注意
• CHANGELOG

分析

先来看一下为什么你会不断收到邮件提醒：

• 为什么我会收到这个 Writer002 仓库的提醒？

  因为你 watching 了这个仓库。参考：

  • About notifications - User Documentation
  • Watching repositories - User Documentation

• 为什么我会 watching 这个仓库？

  原因有很多，比如

  • 你的 notification center 设置的是 Automatic watching ，所以你在 writer 002 仓库发言后就自动 watching 了；
  • 你的 notification center 没设置 Automatic watching ，但你点击了仓库的 watching 选项。

• 为什么我会收到邮件提醒？

  因为你的 notification center 勾选了 email 接收 paticipating & watching 的消息。参考 Managing notification delivery methods - User Documentation。

再看一下课程团队发布重要通告时遵循什么规则：

1. 在 Issues 发布通告正文，正文中输入 @OpenMindClub/writer002 mention writer002 team
2. 在微信群中用群公告的方式 @所有人 通知大伙儿查看该公告 Issue，且给出 Issue 链接
3. 用 email 通知近期需要重点查看的 Issue 公告

嗯哼，基于这些已知信息，现在你基本能根据自己需求，想到如何避免被 issue 信息轰炸又不错过课程重要通知了吧！如果没有，来看看别人如何解决这个问题的----

推荐方案

效果：

• 邮件接收 GitHub 通知，但仅收到自己参与的 Issues 消息和提到（@mention）自己的
• 以会话方式收到，而非每个 Issue comment 都为单独的一封邮件
• 收到 GitHub writer002 邮件能汇总到某个地方，空闲时可集中查阅处理，不会挤爆收件箱干扰正常工作，如图：

所需条件

• 环境上没啥要求，能正常使用 web 版邮箱就好
• 但有习惯要求，以下配置适合经常查看 GitHub 消息人士，如果你平常就很少登陆 GitHub 页面，那请配置完后留意注意1

配置步骤

一、watching 仓库，但 email 只接收 participating 的通知

1. 进入仓库选择 watching，如图：

2. 进入 settting ->notification center，勾选 Participating 和 Watching 选项如图示：

好，这下只收到和自己紧密相关的 email 通知，但能在 https://github.com/notifications 看到所有自己 watching 仓库的动态了。

PS. 如果是你自己个人的仓库，这样设置之后，即使没有 watching 也会接收到邮件提醒的~

二、 配置收信规则过滤邮件

再处理一下炸裂的收件箱，让来自 writer002 repo 的通知不出现在收件箱，直接过滤到某个标签或文件夹下。以本次课程最多人使用的腾讯系邮箱举例：

4. 观察所收到的课程通知邮件共同特点： 5. 发件人都为 [email protected] 6. 邮件主题前缀 Writer002
5. 查询所用邮箱邮件过滤规则配置方式： 什么是收信规则/过滤器？我怎样设置它们？_腾讯邮箱帮助中心 5. 在 如果发件人包含 选项中填入 [email protected] ，在 如果主题中包含 选项中填入 Writer002 ， 4. 将邮件移动到 认知写作学二期 文件夹，并标记 GitHub 标签 5. 保存配置，在弹出的提示中选择应用到已有邮件

哈，收件箱终于清爽了。

三、将收件方式设为会话模式

收到好多单封邮件，查阅主题讨论非常不便。把邮箱设置为会话模式吧，像在 GitHub Issue 页面那样查看每个主题的讨论。方法参见 什么是会话模式和标准模式?_腾讯邮箱帮助中心 。

收工！既不会错过重要通知也不会被邮件轰炸了;-)

其它派系邮箱设置方式也类似：

• 过滤规则设置参见
• Gmail帮助-通过标签和过滤器整理邮件
• 网易邮箱帮助中心_如何设置邮件“来信分类”功能？
  • 不属于以上派系就自行动手检索 收信规则+邮箱域名 等关键词吧
• 会话模式设置参见
  • Gmail 默认为会话模式，不必更改（人生苦短，快用 Gmail）
  • 网易邮箱帮助中心_如何开通/关闭邮件会话?
  • 不属于以上派系就自行动手检索 会话模式+邮箱域名 等关键词吧

总之，GitHub 肯定可以配置成让你舒服的样子，用对 GitHub 能幸福的！

注意

1. 课程会有不少有意思的、由学员发起的 Issue 讨论，按以上方式配置后就没法及时知晓了，所以，建议课程期间至少每三天固定时间看看 GitHub Issues 消息，并重点查看学员群公告通知要看的 Issue；
2. 自己参与了某个 Issue 却不想持续收到 email 通知，比如报名了 认知写作学二期开学典礼 ，可以进入该 Issue 页面，如图示点选该 Issue 旁的 Unsubscribe 选项，这样就不会再收到这个 Issue 的通知啦；
3. 入手一个新工具，先翻官方文档，可以让自己少走很多弯路。遇到问题先找官方文档查阅一手资料也是很多高手的默认习惯。《GitHub Guides》《GitHub Help》，你翻过吗？

CHANGELOG

• 170118 闪闪增补 watching 提示
• 170113 闪闪增补目录
• 160310 闪闪创建