Comment on page
通知,@提及 和引用
通过在问题中使用@提及 和引用,你可以通知其他 GitHub 用户和团队,并相互交叉关联问题。这些方法提供了一种灵活的方式,可以让合适的人员高效地解决问题,并且易于学习和使用。它们适用于 GitHub 上的所有文本字段 —— 它们是我们的文本格式化语法的一部分,称为 GitHub 版 Markdown。

Markdown 例子

通知截屏
通过这些设置,当人们特别提到你时,你会收到邮件,接着就可以访问基于 Web 的界面及时了解你感兴趣的仓库。

个人通知截屏
被静默的通知线程在你再次特别提及之前,将不再显示为未读。这是一个静默你不感兴趣的(可能是你不熟悉的某个子系统)通知线程的一个很好的策略。如果你将问题标记为已读,则它将保持这种状态,直到有人再次对该通知线程发表评论为止。
GitHub 还同步邮件通知的已读/未读状态 —— 如果你在邮件客户端中读取通知,它将在基于 Web 的界面中(如果你喜欢此功能,请确保允许你的邮件客户端显示图片)标记为已读。
@提及 是我们在 GitHub Issues 中引用其他 GitHub 用户的方式。在描述或 issue 的任何评论 内,提及另一个 GitHub 用户的@用户名 以向他们发送通知。这与 Twitter 使用@提及 的方式非常相似。
我们喜欢使用
/cc
语法( 抄送的缩写)来提及 issues 中的人:It looks like the new widget form is broken on Safari. When I try and create the widget, Safari crashes. This is reproducible on 10.8, but not 10.9. Maybe a browser bug?/cc @kneath @jresig
如果你知道要提及的特定用户,这种方法很有用,但很多时候我们在团队中工作但不知道谁可以帮助我们。@提及 也适用于 GitHub 组织内的团队。如果你在@acmeinc 组织下创建一个名为 browser-bugs 的团队,你可以使用@提及 提醒该团队:
/cc @acmeinc/browser-bugs
这将向 browser-bugs 团队的每个成员发送通知。
通常情况下,issues 取决于其他 issues,或者至少与它们有关,并且你希望将这两个 issues 关联起来。你可以通过输入主题标签和问题编号来引用 issues。
Hey @kneath, I think the problem started in #42
当你这样做时,我们将在 issue #42 中创建一个如下所示的事件:
