变更提交#

此页面提供了关于如何向托管在 gitlab.gnome.org 上的项目提交代码变更的高级概述。

先决条件#

要向 GNOME 的 GitLab 实例托管的模块提出更改,您需要

  • 一个可以开发和进行更改的系统

  • 登录到 gitlab.gnome.org

  • 已上传到您的 GitLab 帐户的 SSH 密钥(请参阅 SSH 密钥

  • 能够构建和测试您将要更改的软件模块(请参阅 构建

  • 对如何使用 Git 版本控制 有基本的了解

流程步骤#

以下是提交代码或其他更改所需的的基本步骤

  1. gitlab.gnome.org 上,找到您想要更改的项目

  2. 如果还没有关于您想要改进的内容的 issue 报告,创建一个

  3. 通过 fork 项目来创建您自己的项目副本(请参阅 GitLab 的 fork 工作流指南

  4. 创建您 fork 的本地克隆

  5. 在本地克隆中进行您的更改

    • 创建一个新的分支并切换到该分支

    • 进行您的更改

    • 构建和测试您的更改

    • 使用合适的 提交消息 提交您的更改

    • 将您的分支推送到 GitLab 上的您的 fork

  6. 在 GitLab 中,创建一个合并请求 (MR),将您 fork 中的分支合并到上游主分支。(请记住引用 MR 将要修复的 issue。)

  7. 完成 MR 审查流程

    • 等待维护者审查您的 MR

    • 在 MR 审查后,您可能需要根据审查者的评论进行更改

    • 一旦所有 MR 评论都已解决,您的更改将被合并