diff --git a/docs/user/project/issues/crosslinking.md b/docs/user/project/issues/crosslinking.md index c243fca76a952277064a180e24dc977a88504b50..dce4ec19df1093beb3fb23311605e0a46c43c2d1 100644 --- a/docs/user/project/issues/crosslinking.md +++ b/docs/user/project/issues/crosslinking.md @@ -1,41 +1,35 @@ -# 关联Issue[](#关联issue "Permalink") +# 关联Issue[](#crosslinking-issue "Permalink") -请通读[GitLab 问题文档](index.html)以获取有关 GitLab 问题的概述. +可以访问 Issue 页面了解更多关于 Issue 的内容。 -## From Commit Messages[](#from-commit-messages "Permalink") +## 在提交信息中关联[](#from-commit-messages "Permalink") -每次在提交消息中提及问题时,您都在开发工作流的两个阶段之间建立一种关系:问题本身以及与该问题相关的第一次提交. +每次在提交消息中提及 Issue 时,您都会在开发工作流的两个阶段之间建立一种关系: Issue 本身以及与该 Issue 相关的第一次提交。 -如果问题和您要提交的代码都在同一项目中,则只需在提交消息中添加`#xxx` ,其中`xxx`是问题编号. 如果它们不在同一项目中,则可以将完整的 URL 添加到问题中( `https://gitlab.com///issues/` ). +如果 Issue 和您要提交的代码都在同一项目中,则只需在提交消息中添加`#xxx` ,其中`xxx`是 Issue 编号。如果它们不在同一项目中,则可以将完整的 URL 添加到问题中( `https://codechina.csdn.net///issues/` )。 -``` +```markdown git commit -m "this is my commit message. Ref #xxx" ``` -or +或 +```markdown +git commit -m "this is my commit message. Related to https://codechina.csdn.net///issues/" ``` -git commit -m "this is my commit message. Related to https://gitlab.com///issues/" -``` - -当然,您可以使用自己的 GitLab 实例的 URL 替换`gitlab.com` . - -**注意:**将您的第一次提交与您的问题相关联,对于通过[GitLab Cycle Analytics](https://about.gitlab.com/stages-devops-lifecycle/value-stream-analytics/)跟踪您的过程将非常重要. 它将测量计划该问题的实施所花费的时间,即从创建问题到进行第一次提交之间的时间. - -## From Related Issues[](#from-related-issues "Permalink") -在合并请求中提及相关问题以及其他问题对于您的团队成员和协作者了解有关同一主题的未解决问题很有用. +**注意:**将您的第一次提交与您的 Issue 相关联,对于分析跟踪您的过程将非常重要。它将测量该 Issue 从计划到实施所花费的时间,即从创建 Issue 到进行第一次提交之间的时间。 -如上所述,当您[从提交消息中提到问题](#from-commit-messages)时,您可以执行此操作. +## 在 Issue 中关联[](#from-related-issues "Permalink") -当在问题`#222`提到问题`#111`时,问题`#111`还将在其跟踪器中显示一条通知. 也就是说,您只需提及一次关系即可在两个问题中均显示该关系. 在[合并请求中](#from-merge-requests)提及问题时,也是如此. +在合并请求及在其他 Issue 中提及相关 Issue 对您的团队成员和协作者了解有关同一主题的未解决 Issue 将很有帮助。 -[![issue mentioned in issue](img/b962444c71ad27ba05dfc6bfc69269f4.png)](img/mention_in_issue.png) +如上所述,当您从提交消息中提到 Issue时,您可以执行此操作。 -## From Merge Requests[](#from-merge-requests "Permalink") +当在 Issue `#222`提到 Issue `#111`时,Issue `#111`还将在其跟踪器中显示一条通知,也就是说,您只需提及一次即可在两个Issue 中均显示该关系。在[合并请求中](#from-merge-requests)提及 Issue 时,也是如此。 -Mentioning issues in merge request comments works exactly the same way as they do for [related issues](#from-related-issues). +## 在合并请求中关联[](#from-merge-requests "Permalink") -当您在合并请求说明中提到问题时,它将仅[将问题和合并请求链接在一起](#from-related-issues) . 此外,您还可以[将问题设置](managing_issues.html#closing-issues-automatically)为在合并请求合并后立即[自动关闭](managing_issues.html#closing-issues-automatically) . +在合并请求中提及 Issue 与在 Issue 中关联是一样的步骤。 -[![issue mentioned in MR](img/f36631c8d1fd9cb42fb7c58a495c24be.png)](img/mention_in_merge_request.png) \ No newline at end of file +当您在合并请求说明中提到 Issue 时,它就会[将 Issue 和合并请求链接在一起](#from-related-issues)。此外,您还可以[将 Issue 设置](managing_issues.html#closing-issues-automatically)为在合并请求合并后立即[自动关闭](managing_issues.html#closing-issues-automatically) 。 \ No newline at end of file