user doc done

SUMMARY.md

@@ -4,55 +4,55 @@
 * [概览](docs/overview.md)
 * [组织](docs/user/org.md)
     * [子组织](docs/user/org/sub_org.md)
-* [项目](docs/user/projects.md)
-    * [徽章](docs/user/projects/badges.md)
-    * [批量编辑](docs/user/projects/bulk-edit.md)
+* [项目](docs/user/project.md)
+    * [徽章](docs/user/project/badges.md)
+    * [批量编辑](docs/user/project/bulk-edit.md)
     * [新建项目](docs/basic/create-project.md)
-    * [描述模板](docs/user/projects/discription-template.md)
-    * [文件查找](docs/user/projects/repo/file-find.md)
-    * [合并请求](docs/user/projects/merge-request.md)
-        * [允许协作](docs/user/projects/merge-request/fork-collaboration.md)
-        * [创建合并请求](docs/user/projects/merge-request/create-merge-request.md)
-        * [Cherry-pick](docs/user/projects/merge-request/cherry-pick.md)
-        * [快进合并](docs/user/projects/merge-request/fast-forward.md)
-        * [解决冲突](docs/user/projects/merge-request/resolve-conflicts.md)
-        * [还原](docs/user/projects/merge-request/revert.md)
-        * [评审及管理](docs/user/projects/merge-request/reviewing.md)
-        * [Squash合并](docs/user/projects/merge-request/squash.md)
-        * [合并请求版本](docs/user/projects/merge-request/versions.md)
-        * [草稿](docs/user/projects/merge-request/draft.md)
-    * [项目成员](docs/user/projects/member.md)
-    * [导入](docs/user/projects/import.md)
-        * [Github](docs/user/projects/import/github.md)
-        * [URL](docs/user/projects/import/by-url.md)
-    * [推送选项](docs/user/projects/push-rules.md)
-    * [Releases](docs/user/projects/releases.md)
-    * [代码仓库](docs/user/projects/repo.md)
-        * [分支](docs/user/projects/repo/branches.md)
-        * [Git属性](docs/user/projects/git-attr.md)
-        * [文件指责](docs/user/projects/repo/blame.md)
-        * [文件历史记录](docs/user/projects/repo/history.md)
-        * [镜像仓库](docs/user/projects/repo/mirror.md)
-        * [保护分支](docs/user/projects/protected-branch.md)
-        * [保护Tag](docs/user/projects/protected-tag.md)
-        * [减少仓库大小](docs/user/projects/repo/reduce-repo-size.md)
-        * [GPG签名提交](docs/user/projects/repo/gpg-sign.md)
-        * [文件编辑](docs/user/projects/repo/web-editor.md)
-        * [WebIDE](docs/user/projects//webide.md)
-    * [项目设置](docs/user/projects/settings.md)
-    * [与群组共享项目](docs/user/projects/member/share.md)
-    * [wiki](docs/user/projects/wiki.md)
-* [Issues](docs/user/projects/issues.md)
-    * [机密Issue](docs/user/projects/issues/confidential.md)
-    * [关联Issue](docs/user/projects/issues/crosslinking.md)
-    * [截止日期](docs/user/projects/issues/due-date.md)
-    * [看板](docs/user/projects/kanban.md)
-    * [Issue操作](docs/user/projects/issues/actions.md)
-    * [标签](docs/user/projects/label.md)
-    * [管理Issue](docs/user/projects/issues/manage.md)
-    * [里程碑](docs/user/projects/milestone.md)
-    * [服务台](docs/user/projects/serve-desk.md)
-    * [Issue排序](docs/user/projects/issues/sort.md)
+    * [描述模板](docs/user/project/discription-template.md)
+    * [文件查找](docs/user/project/repo/file-find.md)
+    * [合并请求](docs/user/project/merge-request.md)
+        * [允许协作](docs/user/project/merge-request/fork-collaboration.md)
+        * [创建合并请求](docs/user/project/merge-request/create-merge-request.md)
+        * [Cherry-pick](docs/user/project/merge-request/cherry-pick.md)
+        * [快进合并](docs/user/project/merge-request/fast-forward.md)
+        * [解决冲突](docs/user/project/merge-request/resolve-conflicts.md)
+        * [还原](docs/user/project/merge-request/revert.md)
+        * [评审及管理](docs/user/project/merge-request/reviewing.md)
+        * [Squash合并](docs/user/project/merge-request/squash.md)
+        * [合并请求版本](docs/user/project/merge-request/versions.md)
+        * [草稿](docs/user/project/merge-request/draft.md)
+    * [项目成员](docs/user/project/member.md)
+    * [导入](docs/user/project/import.md)
+        * [Github](docs/user/project/import/github.md)
+        * [URL](docs/user/project/import/by-url.md)
+    * [推送选项](docs/user/project/push-rules.md)
+    * [Releases](docs/user/project/releases.md)
+    * [代码仓库](docs/user/project/repo.md)
+        * [分支](docs/user/project/repo/branches.md)
+        * [Git属性](docs/user/project/git-attr.md)
+        * [文件指责](docs/user/project/repo/blame.md)
+        * [文件历史记录](docs/user/project/repo/history.md)
+        * [镜像仓库](docs/user/project/repo/mirror.md)
+        * [保护分支](docs/user/project/protected-branch.md)
+        * [保护Tag](docs/user/project/protected-tag.md)
+        * [减少仓库大小](docs/user/project/repo/reduce-repo-size.md)
+        * [GPG签名提交](docs/user/project/repo/gpg-sign.md)
+        * [文件编辑](docs/user/project/repo/web-editor.md)
+        * [WebIDE](docs/user/project//webide.md)
+    * [项目设置](docs/user/project/settings.md)
+    * [与群组共享项目](docs/user/project/member/share.md)
+    * [wiki](docs/user/project/wiki.md)
+* [Issues](docs/user/project/issues.md)
+    * [机密Issue](docs/user/project/issues/confidential.md)
+    * [关联Issue](docs/user/project/issues/crosslinking.md)
+    * [截止日期](docs/user/project/issues/due-date.md)
+    * [看板](docs/user/project/kanban.md)
+    * [Issue操作](docs/user/project/issues/actions.md)
+    * [标签](docs/user/project/label.md)
+    * [管理Issue](docs/user/project/issues/manage.md)
+    * [里程碑](docs/user/project/milestone.md)
+    * [服务台](docs/user/project/serve-desk.md)
+    * [Issue排序](docs/user/project/issues/sort.md)
 * [用户](docs/user.md)
     * [举报用户](docs/user/abuse.md)
     * [用户账号](docs/user/account.md)
@@ -65,12 +65,11 @@
     * [快捷键](docs/user/shortcutkey.md)
     * [Markdown](docs/user/markdown.md)
     * [电子邮件通知](docs/user/account/email-notify.md)
-    * [快速操作](docs/user/projects/quick-actions.md)
-        * [自动填充](docs/user/projects/autofill.md)
+    * [快速操作](docs/user/project/quick-actions.md)
+        * [自动填充](docs/user/project/autofill.md)
     * [预留命名空间](docs/user/reserved.md)
     * [搜索](docs/user/search.md)
         * [高级全局搜索](docs/user/search/global.md)
         * [高级语法搜索](docs/user/search/syntax.md)
-    * [时间跟踪](docs/user/projects/time-track.md)
+    * [时间跟踪](docs/user/project/time-track.md)
     * [待办事项](docs/user/todo.md)
\ No newline at end of file
-

docs/user.md

-# 用户文档[](#用户文档 "Permalink")
+# 用户文档[](#user "Permalink")
 
-欢迎来到 GitLab！ 我们很高兴您在这里！
+欢迎您开始使用CODEChina作为您的项目/开源项目代码托管平台！
 
-作为 GitLab 用户，您将有权访问您的[订阅](https://about.gitlab.com/pricing/)包括的所有功能，但[GitLab 管理员](../administration/index.html)设置除外，除非您具有安装，配置和升级 GitLab 实例的管理员权限.
+CODEChina 是一个基于 Git 的平台，它集成了许多用于软件开发和部署以及项目管理的基本工具：
 
-[GitLab.com 的](https://gitlab.com/)管理员特权仅限于 GitLab 团队.
+*   通过版本控制在代码仓库中托管代码
+*   使用功能齐全的[Issues](/project/issues#issues-list)跟踪有关新功能开发、错误报告及反馈的建议
+*   组织和管理Issue(/project/issues#issue-boards)优先次序
+*   使用Review Apps查看[合并请求](/project/merge_requests)中每个分支中更改的代码并实时预览
+*   使用内置的CI/CD构建，测试和部署
+*   使用Pages部署个人/专业静态网站
+*   通过使用容器注册表与 Docker 集成
+*   通过使用价值流分析跟踪开发生命周期
+*   提供[服务台](/project/service_desk)支持
 
-有关配置 GitLab 自管理实例的更多信息，请参阅[管理员文档](../administration/index.html) .
+## 项目[](#project "Permalink")
 
-## Overview[](#overview "Permalink")
+您可以创建[项目](project)来托管代码，跟踪问题，在代码上进行协作。或者，您可以在一个项目中完成下列所有操作：
 
-GitLab 是一个完全集成的软件开发平台，使您的团队能够在同一平台上保持透明，快速，有效和凝聚力，从讨论新想法到正式生产.
+*   [代码仓库](/project/repo.md) ：将[代码库](/project/repo)托管在具有版本控制的存储库中，并作为完全集成平台的一部分
+*   [Issues](/project/issues) ：探索 Issue
+*   [合并请求](/project/merge_requests) ：在代码，评论，每个分支的实时预览更改方面进行协作，并通过合并请求来批准请求
+*   [里程碑](/project/milestone) ：在设置的里程碑日期前处理多个Issue及合并请求
 
-有关更多信息，请参见[所有 GitLab 功能](https://about.gitlab.com/features/) .
+## 账号[](#account "Permalink")
 
-### Concepts[](#concepts "Permalink")
+您可以自定义和配置以下内容：
 
-要熟悉在 GitLab 上开发代码所需的概念，请阅读以下文章：
+*   [设置](/account) ：管理用户设置以更改您的个人信息，个人访问令牌，授权的应用程序等
+*   [权限](/permissions) ：了解每种用户类型（访客，记者，开发人员，维护人员，所有者）的不同权限级别集
+*   [abuse](/abuse) ：向我们的审核人员举报用户的滥用或违规情况
 
-*   [Demo: Mastering Code Review With GitLab](https://about.gitlab.com/blog/2017/03/17/demo-mastering-code-review-with-gitlab/).
-*   [GitLab Workflow: An Overview](https://about.gitlab.com/blog/2016/10/25/gitlab-workflow-an-overview/#gitlab-workflow-use-case-scenario).
-*   [教程：在 GitLab 中都已连接](https://about.gitlab.com/blog/2016/03/08/gitlab-tutorial-its-all-connected/) ：与 GitLab 进行代码协作的概述.
-*   [Trends in Version Control Land: Microservices](https://about.gitlab.com/blog/2016/08/16/trends-in-version-control-land-microservices/).
-*   [Trends in Version Control Land: Innersourcing](https://about.gitlab.com/blog/2016/07/07/trends-version-control-innersourcing/).
+## 组织[](#organization "Permalink")
 
-## Use cases[](#use-cases "Permalink")
+通过建立[组织](/org)您可以将相关项目组合在一起，并授予成员一次访问多个项目的权限。
 
-GitLab 是一个基于 Git 的平台，它集成了许多用于软件开发和部署以及项目管理的基本工具：
+您也可以在组织中嵌套[子组织](/org/sub_org) 
 
-*   通过版本控制在存储库中托管代码.
-*   使用功能齐全的[问题跟踪器](project/issues/index.html#issues-list)跟踪有关新实现，错误报告和反馈的建议.
-*   组织和[发行委员会的](project/issues/index.html#issue-boards)优先次序.
-*   使用[Review Apps](../ci/review_apps/index.html)查看[合并请求中](project/merge_requests/index.html)每个分支的实时预览更改中的代码.
-*   使用内置的[持续集成进行](../ci/README.html)构建，测试和部署.
-*   使用[GitLab Pages](project/pages/index.html)部署个人和专业静态网站.
-*   通过使用[GitLab 容器注册表](packages/container_registry/index.html)与 Docker 集成.
-*   通过使用[GitLab 价值流分析](project/cycle_analytics.html)跟踪开发生命周期.
-*   提供[服务台](project/service_desk.html)支持.
+## 探讨[](#discussions "Permalink")
 
-使用 GitLab 企业版，您还可以：
+您可以在 Issue、合并请求、及提交中添加注释、评论并@相关人员，点击[了解更多](/discussions)。
 
-*   通过以下方式改善协作：
-    *   [合并请求批准](project/merge_requests/merge_request_approvals.html) .
-    *   [问题的多个受让人](project/issues/multiple_assignees_for_issues.html) .
-    *   [多个发行委员会](project/issue_board.html#multiple-issue-boards) .
-*   在[相关问题](project/issues/related_issues.html)之间创建正式关系.
-*   使用[Burndown Charts](project/milestones/burndown_charts.html)可以在冲刺期间或在使用其新版本软件时跟踪进度.
-*   利用[Elasticsearch](../integration/elasticsearch.html)和[Advanced Global Search](search/advanced_global_search.html)和[Advanced Syntax Search](search/advanced_search_syntax.html)在整个 GitLab 实例上进行更快，更高级的代码搜索.
-*   [Authenticate users with Kerberos](../integration/kerberos.html).
-*   从本地服务器上的其他地方[镜像存储库](project/repository/repository_mirroring.html) .
-*   [Export issues as CSV](project/issues/csv_export.html).
-*   使用[Multiple-Project Pipelines](../ci/multi_project_pipeline_graphs.html)查看涉及多个项目的整个 CI / CD [管道](../ci/multi_project_pipeline_graphs.html) .
-*   [锁定文件](project/file_lock.html)以防止冲突.
-*   使用[Deploy Boards](project/deploy_boards.html)查看在 Kubernetes 上运行的每个 CI 环境的当前运行状况和状态.
-*   利用[Canary 部署的](project/canary_deployments.html)连续交付方法.
-*   扫描您的代码中的漏洞， [并在合并请求中显示它们](application_security/sast/index.html) .
+### Markdown[](#markdown "Permalink")
 
-您还可以[将](project/integrations/overview.html) GitLab 与众多第三方应用程序[集成](project/integrations/overview.html) ，例如 Mattermost，Microsoft Teams，HipChat，Trello，Slack，Bamboo CI，Jira 等.
+您可以在[markdown](markdown.html)中了解如何在主题、注释、Issue 及合并请求以及所有支持markdonw的其他地方来使用markdown填写你的内容。
 
-## Projects[](#projects "Permalink")
+## 待办事项[](#todo "Permalink")
 
-在 GitLab 中，您可以创建[项目](project/index.html)来托管代码，跟踪问题，在代码上进行协作以及使用内置的 GitLab CI / CD 持续构建，测试和部署应用程序. 或者，您可以从一个项目中一次完成所有操作.
+[代办事项](/todo)可以让你与组织成员更快速、高效地进行写作，它会将所有用户或组织 @你的内容，也包括你被指派的 Issue 及合并请求，让你不会遗漏任何一个协助者的回复。
 
-*   [存储库](project/repository/index.html) ：将代码[库](project/repository/index.html)托管在具有版本控制的存储库中，并作为完全集成平台的一部分.
-*   [问题](project/issues/index.html) ：探索 GitLab 问题的最佳功能.
-*   [合并请求](project/merge_requests/index.html) ：在代码，评论，每个分支的实时预览更改方面进行协作，并通过合并请求请求批准.
-*   [里程碑](project/milestones/index.html) ：处理多个问题，并与里程碑在同一目标日期合并请求.
+## 搜索[](#search "Permalink")
 
-## GitLab CI/CD[](#gitlab-cicd "Permalink")
+[搜索和筛选](/search)组织、项目、Issue、合并请求、文件以及代码等内容。
 
-使用内置的[GitLab CI / CD](../ci/README.html)直接从 GitLab 测试，构建和部署应用程序. 无需第三方集成.
+## 快捷键[](#shortcutkey "Permalink")
 
-*   [GitLab Auto Deploy](../topics/autodevops/stages.html#auto-deploy) ：通过 GitLab Auto Deploy 开箱即用地部署您的应用程序.
-*   [Review Apps](../ci/review_apps/index.html) ：实时预览带有 Review Apps 的合并请求所引入的更改.
-*   [GitLab 页面](project/pages/index.html) ：使用 GitLab 页面直接从 GitLab 发布您的静态站点. 您可以使用 Pages 构建，测试和部署任何静态站点生成器.
-*   [GitLab Container Registry](packages/container_registry/index.html) ：使用 Container Registry 构建和部署 Docker 映像.
-
-## Account[](#account "Permalink")
-
-您可以自定义和配置很多东西，以享受 GitLab 的最佳体验.
-
-*   [设置](profile/index.html) ：管理用户设置以更改您的个人信息，个人访问令牌，授权的应用程序等.
-*   [身份验证](../topics/authentication/index.html) ：通读 GitLab 中可用的身份验证方法.
-*   [权限](permissions.html) ：了解每种用户类型（访客，记者，开发人员，维护人员，所有者）的不同权限级别集.
-*   [功能亮点](feature_highlight.html) ：了解有关应用周围的小蓝点的更多信息，这些小点可以解释某些功能.
-*   [滥用报告](abuse_reports.html) ：向 GitLab 管理员报告用户的[滥用情况](abuse_reports.html) .
-
-## Groups[](#groups "Permalink")
-
-使用 GitLab [组，](group/index.html)您可以将相关项目组合在一起，并授予成员一次访问多个项目的权限.
-
-组也可以嵌套在[子组中](group/subgroups/index.html) .
-
-## Discussions[](#discussions "Permalink")
-
-在 GitLab 中，您可以在问题，合并请求，代码段和提交中注释和提及合作者.
-
-通过合并请求对代码库的实现执行内联检查时，可以通过[可解析的线程](discussions/index.html#resolvable-comments-and-threads)收集反馈.
-
-### GitLab Flavored Markdown (GFM)[](#gitlab-flavored-markdown-gfm "Permalink")
-
-通读[GFM 文档，](markdown.html)以了解如何在线程，注释，问题和合并请求描述以及所有支持 GFM 的其他地方应用最好的 GitLab 风味 Markdown.
-
-## Todos[](#todos "Permalink")
-
-Never forget to reply to your collaborators. [GitLab Todos](todos.html) are a tool for working faster and more effectively with your team, by listing all user or group mentions, as well as issues and merge requests you’re assigned to.
-
-## Search[](#search "Permalink")
-
-[搜索和筛选](search/index.html)组，项目，问题，合并请求，文件，代码等.
-
-## Snippets[](#snippets "Permalink")
-
-[片段](snippets.html)是您要存储在 GitLab 中的代码块，您可以从中快速访问它们. 您还可以通过" [讨论"](#discussions)收集有关它们的反馈.
-
-## Keyboard shortcuts[](#keyboard-shortcuts "Permalink")
-
-GitLab 中有许多[键盘快捷键](shortcuts.html) ，可帮助您在页面之间导航并更快地完成任务.
-
-## Integrations[](#integrations "Permalink")
-
-[将 GitLab](../integration/README.html)与您喜欢的工具（例如 Trello，Jira 等） [集成](../integration/README.html) .
+CODEChina中支持许多[快捷键](/shortcutkey) ，帮助您更方便的在页面之间进行切换、更快地完成任务。
 
 ## Webhooks[](#webhooks "Permalink")
 
-配置[webhook](project/integrations/webhooks.html)以侦听特定事件，例如推送，问题或合并请求. GitLab 会将带有数据的 POST 请求发送到 webhook URL.
-
-## API[](#api "Permalink")
-
-通过[API](../api/README.html)自动化 GitLab.
-
-## Git and GitLab[](#git-and-gitlab "Permalink")
-
-了解什么是[Git](../topics/git/index.html)及其最佳实践.
-
-## Instance statistics[](#instance-statistics "Permalink")
-
-查看您的 GitLab 实例的[各种统计信息](instance_statistics/index.html) .
-
-## Operations Dashboard[](#operations-dashboard-premium "Permalink")
-
-See [Operations Dashboard](operations_dashboard/index.html) for a summary of each project’s operational health.
\ No newline at end of file
+配置webhook]以侦听特定事件，例如推送，问题或合并请求。CODEChina会将相关数据通过 POST 请求发送到 webhook 中配置的 URL 中。
\ No newline at end of file

docs/user/account/email-notify.md

-# 电子邮件通知
+# 电子邮件通知[](#电子邮件通知 "Permalink")
 
+GitLab 通知使您可以随时了解 GitLab 中发生的事情. 启用通知后，您可以接收有关问题，合并请求和史诗活动的更新. 通知通过电子邮件发送.
+
+## Receiving notifications[](#receiving-notifications "Permalink")
+
+您将由于以下原因之一收到通知：
+
+*   您参与发行，合并请求或史诗. 在这种情况下， *参与*意味着评论或编辑.
+*   You enable notifications in an issue, merge request, or epic. To enable notifications, click the **Notifications** toggle in the sidebar to *on*.
+
+启用通知后，您将收到有关该问题，合并请求或史诗中发生的操作的通知.
+
+**注意：**通知可能会被管理员阻止，从而阻止发送通知.
+
+## Tuning your notifications[](#tuning-your-notifications "Permalink")
+
+通知的数量可能是巨大的. GitLab 允许您调整收到的通知. 例如，您可能希望收到有关特定项目中所有活动的通知，而对于其他项目，仅当您的名字被提及时才得到通知.
+
+您可以通过组合通知设置来调整收到的通知：
+
+*   [Global notification settings](#global-notification-settings)
+*   [Notification scope](#notification-scope)
+*   [Notification levels](#notification-levels)
+
+### Editing notification settings[](#editing-notification-settings "Permalink")
+
+编辑通知设置：
+
+1.  点击您的个人资料图片，然后选择**设置** .
+2.  点击左侧边栏中的**通知** .
+3.  编辑所需的通知设置. 编辑的设置将自动保存并启用.
+
+这些通知设置仅适用于您. 它们不会影响同一项目或组中其他任何人收到的通知.
+
+[![notification settings](img/81fe297de1dccaedd3340735454273bc.png)](img/notification_global_settings.png)
+
+## Global notification settings[](#global-notification-settings "Permalink")
+
+**全局通知设置**是默认设置，除非您为项目或组选择不同的值.
+
+*   通知电子邮件
+    *   这是您的通知将发送到的电子邮件地址.
+*   全局通知级别
+    *   这是适用于所有通知的默认[通知级别](#notification-levels) .
+*   接收有关您自己的活动的通知.
+    *   如果您想接收有关自己活动的通知，请选中此复选框. 默认值：未选中.
+
+### Notification scope[](#notification-scope "Permalink")
+
+您可以通过为每个项目和组选择不同的通知级别来调整通知的范围.
+
+通知范围按优先级顺序应用（从高到低）：
+
+*   Project
+    *   对于每个项目，您可以选择一个通知级别. 您的项目设置将覆盖组设置.
+*   Group
+    *   对于每个组，您可以选择一个通知级别. 您的群组设置会覆盖您的默认设置.
+*   全局（默认）
+    *   如果尚未为发生活动的项目或组选择通知级别，则将应用全局或*默认*通知级别.
+
+#### Project notifications[](#project-notifications "Permalink")
+
+您可以为每个项目选择一个通知级别. 如果您需要密切监视选定项目中的活动，这将很有用.
+
+[![notification settings](img/bab81ba0a915cec8b039166d2defc074.png)](img/notification_project_settings_v12_8.png)
+
+要为项目选择通知级别，请使用以下两种方法之一：
+
+1.  点击您的个人资料图片，然后选择**设置** .
+2.  点击左侧边栏中的**通知** .
+3.  在" **项目"**部分中找到该项目.
+4.  选择所需的[通知级别](#notification-levels) .
+
+Or:
+
+1.  导航到项目页面.
+2.  单击带有下拉图标的通知下拉列表.
+3.  选择所需的[通知级别](#notification-levels) .
+
+有关如何在有新版本发布时通知的演示，请参阅[发布通知](https://www.youtube.com/watch?v=qyeNkGgqmH4) .
+
+#### Group notifications[](#group-notifications "Permalink")
+
+您可以为每个组选择通知级别和电子邮件地址.
+
+[![notification settings](img/c39dc466882289b42ad827dbbc05b39f.png)](img/notification_group_settings_v12_8.png)
+
+##### Group notification level[](#group-notification-level "Permalink")
+
+要为组选择通知级别，请使用以下两种方法之一：
+
+1.  点击您的个人资料图片，然后选择**设置** .
+2.  点击左侧边栏中的**通知** .
+3.  在" **组"**部分中找到该项目.
+4.  选择所需的[通知级别](#notification-levels) .
+
+* * *
+
+1.  导航到组的页面.
+2.  单击带有下拉图标的通知下拉列表.
+3.  选择所需的[通知级别](#notification-levels) .
+
+##### Group notification email address[](#group-notification-email-address "Permalink")
+
+在 GitLab 12.0 中引入
+
+您可以选择一个电子邮件地址，以接收您所属的每个组的通知. 例如，如果您是自由职业者，并且希望将有关客户项目的电子邮件分开存放，这可能会很有用.
+
+1.  点击您的个人资料图片，然后选择**设置** .
+2.  点击左侧边栏中的**通知** .
+3.  在" **组"**部分中找到该项目.
+4.  选择所需的电子邮件地址.
+
+### Notification levels[](#notification-levels "Permalink")
+
+对于每个项目和组，您可以选择以下级别之一：
+
+| Level | Description |
+| --- | --- |
+| Global | 您的全局设置适用. |
+| Watch | 接收任何活动的通知. |
+| 提一下 | `@mentioned`在评论中`@mentioned`接收通知. |
+| Participate | 接收有关您参与的线程的通知. |
+| Disabled | 关闭通知. |
+| Custom | 接收有关自定义选定事件的通知. |
+
+## Notification events[](#notification-events "Permalink")
+
+将通知用户以下事件：
+
+| Event | 发给 | 设定等级 |
+| --- | --- | --- |
+| 添加了新的 SSH 密钥 | User | 安全电子邮件，始终发送. |
+| 添加了新电子邮件 | User | 安全电子邮件，始终发送. |
+| 电邮已变更 | User | 安全电子邮件，始终发送. |
+| 密码已更改 | User | 安全电子邮件，始终发送. |
+| 新用户创建 | User | 在创建用户时发送，但 OmniAuth（LDAP）除外 |
+| 用户已添加到项目 | User | 将用户添加到项目时发送 |
+| 项目访问权限级别已更改 | User | 更改用户项目访问级别时发送 |
+| 用户已添加到组 | User | 将用户添加到组时发送 |
+| 群组访问权限级别已更改 | User | 更改用户组访问级别时发送 |
+| 项目已移 | 项目成员（1） | （1）不禁用 |
+| 新品发布 | 项目成员 | 自定义通知 |
+
+## Issue / Epics / Merge request events[](#issue--epics--merge-request-events "Permalink")
+
+在以下大多数情况下，通知将发送到：
+
+*   Participants:
+    *   发行/合并请求的作者和受让人
+    *   关于问题/合并请求的评论的作者
+    *   `@username`在问题，合并请求或史诗的标题或描述中提到的任何人
+    *   `@username`在有关问题，合并请求或史诗的任何评论中提及的"参与"或更高通知级别的任何人
+*   观察者：通知级别为"观察"的用户
+*   订阅者：手动订阅问题，合并请求或史诗的任何人
+*   自定义：通知级别为"自定义"的用户针对下表中显示的任何事件打开了通知
+
+**注意：**为了最大程度地减少不需要任何操作的通知的数量，从[GitLab 12.9 起](https://gitlab.com/gitlab-org/gitlab/-/issues/616) ，不再为项目中的所有活动通知合格的批准者. 要接收它们，他们必须将其用户通知设置更改为" **观看"** .
+
+| Event | 发给 |
+| --- | --- |
+| 新问题 |   |
+| 结束期 |   |
+| 重新分配问题 | 以上，加上旧的受让人 |
+| 重新打开问题 |   |
+| 到期问题 | 选择此事件的参与者和自定义通知级别 |
+| 更改里程碑问题 | 选择了此事件的订户，提及的参与者和自定义通知级别 |
+| 消除里程碑问题 | 选择了此事件的订户，提及的参与者和自定义通知级别 |
+| 新合并请求 |   |
+| 推送合并请求 | 选择此事件的参与者和自定义通知级别 |
+| 重新分配合并请求 | 以上，加上旧的受让人 |
+| 关闭合并请求 |   |
+| 重新打开合并请求 |   |
+| 合并合并请求 |   |
+| 更改里程碑合并请求 | 选择了此事件的订户，提及的参与者和自定义通知级别 |
+| 删除里程碑合并请求 | 选择了此事件的订户，提及的参与者和自定义通知级别 |
+| 新评论 | 以上内容，加上评论中`@username`提及的任何人，通知级别为"提及"或更高 |
+| 管道失败 | 管道的作者 |
+| 固定管道 | 管道的作者. 默认启用. 在 GitLab 13.1 中[引入](https://gitlab.com/gitlab-org/gitlab/-/issues/24309) . 管理员可以使用`ci_pipeline_fixed_notifications` [功能标记](../../administration/feature_flags.html)禁用此通知选项. |
+| 成功的管道 | 管道的作者（如果他们具有成功管道的自定义通知设置）. 如果管道先前失败，则将为失败后的第一个成功管道发送`Fixed pipeline`消息，然后为任何进一步成功的管道发送`Successful pipeline`消息. |
+| 新史诗 |   |
+| 接近史诗 |   |
+| 重新开启史诗 |   |
+
+此外，如果发布或合并请求的标题或描述发生了更改，则通知将通过`@username`发送到任何**新**提及的内容，就像在原始文本中提到的一样.
+
+您不会收到有关您自己创建的问题，合并请求或里程碑的通知（除非由于问题而定）. 仅当其他人对您创建或提及的内容进行评论或添加更改时，您才会收到自动通知.
+
+如果开放的合并请求由于冲突而变得不可合并，则将通知其原因. 如果用户还将合并请求设置为一旦管道成功就自动合并，则该用户也会收到通知.
+
+## Filtering email[](#filtering-email "Permalink")
+
+通知电子邮件包括特定于 GitLab 的标题. 您可以根据这些标头的内容过滤通知电子邮件，以更好地管理您的通知. 例如，您可以过滤特定项目的所有电子邮件，在该项目中您将被分配合并请求或问题.
+
+下表列出了所有特定于 GitLab 的电子邮件标题：
+
+| Header | Description |
+| --- | --- |
+| `X-GitLab-Group-Id` | 组的 ID. 仅在史诗的通知电子邮件中显示. |
+| `X-GitLab-Group-Path` | 组的路径. 仅在史诗的通知电子邮件中显示. |
+| `X-GitLab-Project` | 通知所属的项目的名称. |
+| `X-GitLab-Project-Id` | 项目的 ID. |
+| `X-GitLab-Project-Path` | 项目的路径. |
+| `X-GitLab-(Resource)-ID` | 通知所针对的资源的 ID. 该资源例如可以是`Issue` ， `MergeRequest` ， `Commit`或其他此类资源. |
+| `X-GitLab-Discussion-ID` | 注释所属的线程的 ID，用于注释的通知电子邮件中. |
+| `X-GitLab-Pipeline-Id` | 通知所针对的管道的 ID，在管道的通知电子邮件中. |
+| `X-GitLab-Reply-Key` | 支持通过电子邮件回复的唯一令牌. |
+| `X-GitLab-NotificationReason` | 通知原因. 可以`mentioned` ， `assigned`或`own_activity` . |
+| `List-Id` | The path of the project in an RFC 2919 mailing list identifier. This is useful for email organization with filters, for example. |
+
+### X-GitLab-NotificationReason[](#x-gitlab-notificationreason "Permalink")
+
+`X-GitLab-NotificationReason`标头包含`X-GitLab-NotificationReason`的原因. 该值是按优先级顺序的以下值之一：
+
+*   `own_activity`
+*   `assigned`
+*   `mentioned`
+
+通知的原因也包含在通知电子邮件的页脚中. 例如有原因的电子邮件`assigned`都会有这句话的注脚：
+
+*   `You are receiving this email because you have been assigned an item on <configured GitLab hostname>.`
+
+**注意：**正在考虑将其他事件的通知包含在`X-GitLab-NotificationReason`标头中. 有关详细信息，请参见此[相关问题](https://gitlab.com/gitlab-org/gitlab/-/issues/20689) .
\ No newline at end of file