您可以在您的存储库中创建问题以计划、讨论和跟踪工作。问题创建起来很快,灵活且用途广泛。问题可以跟踪错误报告、新功能和想法,以及您需要记录或与团队讨论的任何其他内容。您还可以通过添加子问题进一步细化工作,并轻松浏览要完成的工作的完整层次结构。
问题可以通过多种方式创建,因此您可以选择最适合您工作流程的方法。例如,您可以在添加子问题的同时从存储库创建问题,转换问题或拉取请求中的评论,从特定代码行创建问题,或通过 URL 查询创建问题。您还可以通过您选择的平台创建问题:通过 Web UI、GitHub Desktop、GitHub CLI、GraphQL 和 REST API 或 GitHub 移动端。请参阅“创建问题”。
关于子问题
注意
问题类型、子问题和高级问题搜索目前处于组织的可选加入公开预览版中。要了解更多信息并将您的组织添加到候补名单,请参阅“GitHub 博客”。
您可以将子问题添加到问题中,以快速将较大的工作分解成任务。子问题通过在您的问题之间创建关系,为 GitHub 上的问题层次结构添加支持。您可以创建多级子问题,通过将任务分解成您和您的团队所需的确切细节来准确地表示您的项目。请参阅“添加子问题”和“浏览子问题”。
关于与 GitHub 的集成
问题与您在整个 GitHub 中的工作集成在一起。在另一个问题或拉取请求中提及问题将创建它们之间的引用,并在拉取请求中使用关键字(如 fixes:
)将自动关闭关联的问题。请参阅“将拉取请求链接到问题”。
项目与问题紧密集成。您所有的问题元数据都可以在您的项目中使用,使您可以创建视图和筛选器来表示您的工作。请参阅“关于项目”。
保持最新
要随时了解某个 issue 中最新的评论,您可以订阅该 issue 以接收有关最新评论的通知。要快速找到您订阅的最近更新的 issue 的链接,请访问您的仪表盘。有关更多信息,请参阅“关于通知”和“关于您的个人仪表盘”。
您可以将自己和团队成员分配到 issue,以便明确谁在处理某个 issue,并方便您查找自己的 issue。请参阅“将 issue 和拉取请求分配给其他 GitHub 用户”和“查看您所有的 issue 和拉取请求”。
社区管理
为了帮助贡献者提交有意义的 issue 并提供您所需的信息,您可以使用 issue 表单和 issue 模板。请参阅“使用模板鼓励有用的 issue 和拉取请求”。
为了维护健康的社区,您可以举报违反 GitHub 的社区准则的评论。请参阅“举报滥用或垃圾邮件”。
高效沟通
您可以在 issue 中@提及有权访问您代码库的合作者,以引起他们对某条评论的注意。要链接同一代码库中的相关 issue,您可以键入#
,然后输入 issue 标题的一部分,然后点击您要链接的 issue。要传达责任,您可以分配 issue。如果您发现自己经常键入相同的评论,可以使用保存的回复。请参阅“基本写作和格式语法”和“将 issue 和拉取请求分配给其他 GitHub 用户”。
比较 issue 和讨论
某些对话更适合在 GitHub Discussions 中进行。您可以使用 GitHub Discussions 来提问和回答问题、共享信息、发布公告以及进行或参与有关项目的对话。有关更多信息,请参阅“关于讨论”。有关何时使用 issue 或讨论的指南,请参阅“在 GitHub 上沟通”。
当 issue 中的对话更适合于讨论时,您可以将该 issue 转换为讨论。