Contribute to GitLab · Gitlab 中文文檔

# Contribute to GitLab > 原文：[https://docs.gitlab.com/ee/development/contributing/](https://docs.gitlab.com/ee/development/contributing/) * [Security vulnerability disclosure](#security-vulnerability-disclosure) * [Code of conduct](#code-of-conduct) * [Closing policy for issues and merge requests](#closing-policy-for-issues-and-merge-requests) * [Helping others](#helping-others) * [How to contribute](#how-to-contribute) * [GitLab Development Kit](#gitlab-development-kit) * [Contribution flow](#contribution-flow) * [Issues workflow](#issues-workflow) * [Merge requests workflow](#merge-requests-workflow) * [Style guides](#style-guides) * [Implement design & UI elements](#implement-design--ui-elements) * [Contribute documentation](#contribute-documentation) * [Getting an Enterprise Edition License](#getting-an-enterprise-edition-license) # Contribute to GitLab[](#contribute-to-gitlab "Permalink") 感謝您有興趣為 GitLab 做貢獻. 本指南詳細介紹了如何以每個人都容易的方式為 GitLab 做出貢獻. For a first-time step-by-step guide to the contribution process, see our [Contributing to GitLab](https://about.gitlab.com/community/contribute/) page. 尋找工作嗎？有關更多信息，請參見[如何貢獻](#how-to-contribute)部分. GitLab 有兩種口味： * GitLab 社區版（CE），我們的免費和開源版本. * GitLab 企業版（EE），這是我們的商業版. 在本指南中，您將看到對 CE 和 EE 的縮寫的引用. 要獲得 GitLab 社區成員資格的概述，包括那些會審核或合并您的貢獻的成員，請訪問[社區角色頁面](community_roles.html) . 如果您想知道 GitLab [核心團隊的](https://about.gitlab.com/community/core-team/)運作方式，請參閱[GitLab 貢獻過程](https://gitlab.com/gitlab-org/gitlab/blob/master/PROCESS.md) . GitLab Inc 工程師應參考[工程工作流程文檔](https://about.gitlab.com/handbook/engineering/workflow/) . ## Security vulnerability disclosure[](#security-vulnerability-disclosure "Permalink") 將可疑的安全漏洞[秘密](https://about.gitlab.com/security/disclosure/)報告給`support@gitlab.com` ，另請參閱[GitLab.com 網站上的](https://about.gitlab.com/security/disclosure/) " [披露"部分](https://about.gitlab.com/security/disclosure/) . **危險：** **不要**為疑似安全漏洞公開可見的問題. ## Code of conduct[](#code-of-conduct "Permalink") 我們希望為每個有志于貢獻的人營造一個溫馨的環境. 請訪問我們的[《行為準則》頁面，](https://about.gitlab.com/community/contribute/code-of-conduct/)以了解有關我們對開放友好環境的承諾的更多信息. ## Closing policy for issues and merge requests[](#closing-policy-for-issues-and-merge-requests "Permalink") GitLab 是一個受歡迎的開源項目，處理問題和合并請求的能力有限. 出于對我們志愿者的尊重，不符合本文檔所列準則的問題和合并請求可能會被關閉，恕不另行通知. 以禮貌和尊重的態度對待我們的志愿者，這將大大有助于您解決問題. 發行和合并請求應使用英語，并包含適合所有年齡段受眾的語言. 如果貢獻者不再主動處理提交的合并請求，我們可以： * 決定合并請求將由我們的[合并請求指導者之一完成](https://about.gitlab.com/company/team/) . * 關閉合并請求. 我們根據更改對我們的產品愿景的重要性來做出此決定. 如果合并請求教練將要完成合并請求，我們指定`~coach will finish`標簽. 當團隊成員選擇社區貢獻時，我們會通過添加一個記入作者的更改日志條目來記入原始作者，并有選擇地將原始作者包括在 MR 中的至少一項提交中. ## Helping others[](#helping-others "Permalink") 可以的話，請幫助其他 GitLab 用戶. 人們用于尋求幫助的方法可以在" [獲得幫助"頁面](https://about.gitlab.com/get-help/)上找到. 注冊郵件列表，在 StackOverflow 上回答 GitLab 問題，或在 IRC 頻道中回復. ## How to contribute[](#how-to-contribute "Permalink") 如果您想為 GitLab 做出貢獻： * [`~Accepting merge requests`標簽的問題](issue_workflow.html#label-for-community-contributors)是一個很好的起點. * 請查閱" [貢獻流"](#contribution-flow)部分以了解該過程. 如果您有任何疑問或需要幫助，請訪問" [獲得幫助"](https://about.gitlab.com/get-help/)以了解如何與 GitLab 進行通信. 我們有一個[供參與者](https://gitter.im/gitlab/contributors)使用的[Gitter 通道](https://gitter.im/gitlab/contributors) ，但是相對于實時通信，我們更喜歡[異步](https://about.gitlab.com/handbook/communication/#internal-communication)通信. 感謝您的貢獻！ ### GitLab Development Kit[](#gitlab-development-kit "Permalink") GitLab 開發套件（GDK）可幫助貢獻者使用所有必需的依賴項來運行本地 GitLab 實例. 在提出合并請求之前，它可以用于測試對 GitLab 和相關項目的更改. 有關更多信息，請參見[`gitlab-development-kit`](https://gitlab.com/gitlab-org/gitlab-development-kit)項目. ### Contribution flow[](#contribution-flow "Permalink") 對 GitLab 進行貢獻的一般流程是： 1. [創建一個](../../user/project/repository/forking_workflow.html#creating-a-fork) GitLab [的叉子](../../user/project/repository/forking_workflow.html#creating-a-fork) . 在某些情況下，您將需要設置[GitLab 開發套件](https://gitlab.com/gitlab-org/gitlab-development-kit)以[針對 fork](https://gitlab.com/gitlab-org/gitlab-development-kit/-/blob/master/doc/index.md#develop-in-your-own-gitlab-fork)進行[開發](https://gitlab.com/gitlab-org/gitlab-development-kit/-/blob/master/doc/index.md#develop-in-your-own-gitlab-fork) . 2. 在叉子上進行更改. 3. 準備就緒后， [創建一個新的合并請求](../../user/project/merge_requests/creating_merge_requests.html) . 4. 在合并請求的描述中： * 確保您提供完整而準確的信息. * 查看提供的清單. 5. 將合并請求（如果可能）分配給相關項目的[代碼所有者](../../user/project/code_owners.html)之一或`@mention` ，并說明您已準備好進行審查. 當您向 GitLab 提交代碼時，我們真的希望它被合并！但是，我們始終會仔細審查提交的內容，這需要時間. 合并之前，代碼提交通常會由兩位[領域專家](../code_review.html#domain-experts)進行審核： * A [reviewer](../code_review.html#the-responsibility-of-the-reviewer). * A [maintainer](../code_review.html#the-responsibility-of-the-maintainer). 提交合并請求時，請牢記以下幾點： * 當審閱者閱讀合并請求時，他們可能會要求其他審閱者提供指導. * 如果發現代碼質量不符合 GitLab 的標準，則合并請求審閱者將提供指導，并將作者推薦給我們： * [文檔](../documentation/styleguide.html)樣式指南. * 代碼樣式指南. * 有時會遵循樣式指南，但是代碼將缺乏結構完整性，或者審閱者會對??代碼的整體質量有所保留. 如有保留，審閱者將通知作者并提供一些指導. * 盡管 GitLab 通常允許任何人表明對合并請求的[批準](../../user/project/merge_requests/merge_request_approvals.html) ，但是維護者在合并合并請求之前可能需要[獲得某些審閱者的批準](../code_review.html#approval-guidelines) . * 審核后，可能會要求作者更新合并請求. 合并請求更新并重新分配給審閱者后，他們將再次審閱代碼. 在合并之前，此過程可以重復任意次數，以幫助做出最佳的貢獻. 有時，維護者可能會選擇關閉合并請求. 他們將充分披露為什么不合并的原因以及一些指導. 維護人員將公開討論如何更改代碼，以便將來可以批準和合并. manbetx 客戶端打不開將盡其所能盡快審查社區貢獻. 專門任命的開發人員每天審查社區貢獻. 在[團隊頁面上](https://about.gitlab.com/company/team/)查看合并請求指導者，他專門研究您編寫的代碼類型，并在合并請求中提及他們. 例如，如果您編寫了一些前端代碼，則應`@mention`前端合并請求指導程序. 如果您的代碼具有多個學科，則可以`@mention`多個合并請求指導. GitLab 收到了很多社區的貢獻. 如果您的代碼在其初次提交后的兩個工作日內仍未得到審查，請`@mention`與`@gitlab-org/coaches`合并的所有請求`@gitlab-org/coaches`引起他們的注意. 在向 GitLab 提交代碼時，您可能會覺得您的貢獻需要外部庫的幫助. 如果您的代碼包含外部庫，請提供該庫的鏈接，以及包含該庫的原因. `@mention`維護者在合并請求中包含： * 超過 500 種變化. * 任何重大變化. * 外部庫. 如果您不確定要提及誰，則審閱者將在合并請求過程的早期為您完成此操作. #### Issues workflow[](#issues-workflow "Permalink") This [documentation](issue_workflow.html) outlines the current issue workflow: * [Issue tracker guidelines](issue_workflow.html#issue-tracker-guidelines) * [Issue triaging](issue_workflow.html#issue-triaging) * [Labels](issue_workflow.html#labels) * [Feature proposals](issue_workflow.html#feature-proposals) * [Issue weight](issue_workflow.html#issue-weight) * [Regression issues](issue_workflow.html#regression-issues) * [Technical and UX debt](issue_workflow.html#technical-and-ux-debt) * [Technical debt in follow-up issues](issue_workflow.html#technical-debt-in-follow-up-issues) #### Merge requests workflow[](#merge-requests-workflow "Permalink") 本[文檔](merge_request_workflow.html)概述了當前的合并請求過程. * [Merge request guidelines](merge_request_workflow.html#merge-request-guidelines) * [Contribution acceptance criteria](merge_request_workflow.html#contribution-acceptance-criteria) * [Definition of done](merge_request_workflow.html#definition-of-done) * [Dependencies](merge_request_workflow.html#dependencies) ## Style guides[](#style-guides "Permalink") 本[文檔](style_guides.html)概述了當前的樣式準則. ## Implement design & UI elements[](#implement-design--ui-elements "Permalink") 本[設計文檔](design.html)概述了實現設計和 UI 元素的當前過程. ## Contribute documentation[](#contribute-documentation "Permalink") 有關如何編寫文檔的信息，請參見 GitLab [文檔指南](../documentation/index.html) . ## Getting an Enterprise Edition License[](#getting-an-enterprise-edition-license "Permalink") 如果您需要用于貢獻 EE 功能的許可證，請參閱[相關信息](https://about.gitlab.com/handbook/marketing/community-relations/code-contributor-program/#for-contributors-to-the-gitlab-enterprise-edition-ee) .