From 397fdc11322008a4694845414ffb982dd97ba786 Mon Sep 17 00:00:00 2001 From: cont1nu1ty <808535fm@gmail.com> Date: Tue, 14 Oct 2025 14:43:04 +0800 Subject: [PATCH 1/6] docs(contributor): add cont1nu1ty.md for first PR --- cont1nu1ty.md | 1 + 1 file changed, 1 insertion(+) create mode 100644 cont1nu1ty.md diff --git a/cont1nu1ty.md b/cont1nu1ty.md new file mode 100644 index 0000000..af6b537 --- /dev/null +++ b/cont1nu1ty.md @@ -0,0 +1 @@ +这是我的第一次 PR From 4e4d93a7a14892ba3022ab9fbf8f0ddb70d950d3 Mon Sep 17 00:00:00 2001 From: cont1nu1ty <808535fm@gmail.com> Date: Wed, 15 Oct 2025 18:35:10 +0800 Subject: [PATCH 2/6] docs(cont1nu1ty.md):move cont1nu1ty.md to records --- cont1nu1ty.md => records/cont1nu1ty.md | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename cont1nu1ty.md => records/cont1nu1ty.md (100%) diff --git a/cont1nu1ty.md b/records/cont1nu1ty.md similarity index 100% rename from cont1nu1ty.md rename to records/cont1nu1ty.md From 94ba4207d3905a916ca1617c3c6a9e9d1c927757 Mon Sep 17 00:00:00 2001 From: cont1nu1ty <808535fm@gmail.com> Date: Wed, 15 Oct 2025 19:59:33 +0800 Subject: [PATCH 3/6] docs(README.md): add more substantial text introduction --- README.md | 97 +++++++++++++++++++++++++++++++++++++++---------------- 1 file changed, 69 insertions(+), 28 deletions(-) diff --git a/README.md b/README.md index 4725fce..9c25452 100644 --- a/README.md +++ b/README.md @@ -1,44 +1,85 @@ # code-contributing-practice -> 练习代码贡献中的 `fork` 、`pull request` 等操作。 +> 欢迎来到开源贡献练习场!本仓库旨在帮助你熟悉并掌握向开源项目贡献代码的标准流程,包括 fork、git branch、pull request (PR) 等核心操作。 ## 为仓库贡献代码应当怎么做? -- 注意阅读仓库的 `contributing.md` 文档,它通常位于仓库的根目录或 `docs` 文件夹下。 -- 认领 issue -- 开始编码 - - 创建 Fork 仓库或同步 Fork 仓库 - - 创建或选定分支 - - 提交代码 -- 创建 Pull Request - - 在 PR 的描述部分中加上 `close #123` (假定你要完成的 issue 编号是 123 的话) - -- 等待代码审查 - +### 1. 准备工作 + +- **阅读贡献指南**:在项目根目录找到并阅读 `CONTRIBUTING.md` 文件,了解代码规范。 +- **认领 Issue**:找到或创建一个 `Issue`,评论表示你希望处理它,并等待分配。 + +### 2. 本地开发 + +1. **Fork 仓库**:点击原始仓库右上角的 `Fork` 按钮,复制一份到你的 GitHub 账号下。 + +2. **Clone 到本地**: + ```bash + # 将 YOUR_USERNAME 替换为你的 GitHub 用户名 + git clone [https://github.com/YOUR_USERNAME/code-contributing-practice.git](https://github.com/YOUR_USERNAME/code-contributing-practice.git) + cd code-contributing-practice + ``` + +3. **创建特性分支**:**不要在 `main` 分支上直接修改。** + ```bash + # 分支名应清晰并与任务相关,例如:fix/issue-123 + git checkout -b feature/my-first-contribution + ``` + +4. **(可选) 同步上游仓库**:在开始修改前,获取原始仓库的最新代码以避免冲突。 + ```bash + git remote add upstream [https://github.com/FrogDar/code-contributing-practice.git](https://github.com/FrogDar/code-contributing-practice.git) + git fetch upstream + git checkout main + git merge upstream/main + git checkout feature/my-first-contribution + git rebase main # 将你的分支变基到最新的 main 分支上 + ``` + +5. **修改与提交**:完成代码修改后,按照规范提交。 + ```bash + git add . + git commit -m "feat(records): add practice file for YOUR_NAME" + ``` + +6. **推送至你的 Fork 仓库**: + ```bash + git push origin feature/my-first-contribution + ``` + +### 3. 创建 Pull Request (PR) + +- **发起 PR**:在你的 Fork 仓库页面,点击 `Compare & pull request` 按钮。 +- **填写描述**: + - **标题**:清晰概括你的修改。 + - **关联 Issue**:在描述中写入 `close #123` (`123` 为对应的 Issue 编号),PR 合并后会自动关闭该 Issue。 + +### 4. 代码审查 + +- **等待审查**:维护者会对你的代码进行审查并提出修改意见。 +- **更新代码**:若有修改,直接在本地的同一分支上继续 `commit` 和 `push`,PR会自动同步更新。 +- **合并**:PR 被批准并合并后,你就完成了一次贡献! ## 练习 > 在练习中提交的内容没有限制,可以是在 `records` 文件夹下提交一个属于自己的 `.md` 文件,也可以是完善本仓库。 > > 需要注意的是,练习失败的那些产物对于新手来说只能是删掉再来一次。当然你也可以通过提升自己的 git 水平,用一些奇淫巧技拯救此前错误的练习结果。 -### 练习一 - -练习目标:完成第一次提交 - -注意事项: - -- 创建一个 issue,标题命名为 `Ex1` 或 `ex1` 或 `练习1` 或 `练习一`,机器人会将它分配给你,成为你的专属练习 issue -- 记得查看 [`CONTRIBUTING.md`](https://github.com/FrogDar/code-contributing-practice/blob/main/CONTRIBUTING.md) 里的规范(比如 git message 要使用 [`angular` 规范](https://github.com/angular/angular/blob/main/CONTRIBUTING.md)) -- 建议自己创建一个分支,并在分支上修改后提交 PR,具体做法和理由见练习二。 - -### 练习二 +### 练习一:完成第一次贡献 -练习目标:完成第二次提交 +- **目标**:完整体验一次标准的 Fork & PR 流程。 +- **步骤**: + 1. 创建一个 Issue,标题为 `Ex1` 或 `练习一`,机器人会自动分配给你。 + 2. 严格遵循上述标准流程。 + 3. 遵守 `CONTRIBUTING.md` 中的规范(特别是 commit message 规范)。 -注意事项: +### 练习二:处理多个提交 -- 创建一个 issue,标题命名为 `Ex2` 或 `ex2` 或 `练习2` 或 `练习二`,机器人会将它分配给你,成为你的专属练习 issue -- 务必保持此次提交不包括上次提交的 git message。 +- **目标**:学习在同一 PR 中进行多次提交,并保持提交历史的干净。 +- **步骤**: + 1. 创建一个 Issue,标题为 `Ex2` 或 `练习二`。 + 2. **务必为本次练习创建一条新分支**。 + 3. 确保本次 PR 不包含上一次练习的提交记录。 ## TODO @@ -46,4 +87,4 @@ - [x] 完成第一个贡献流程 - [x] 完成一次手动评判 - [x] 利用 `GitHub Actions` 自动评判流程并给予提示 -- [ ] 更为充实的文字介绍 +- [x] 更为充实的文字介绍 From 94649bfc6272a1545a5a14186844671a7aafe717 Mon Sep 17 00:00:00 2001 From: cont1nu1ty <808535fm@gmail.com> Date: Thu, 16 Oct 2025 14:28:49 +0800 Subject: [PATCH 4/6] docs(README.md): testing --- README.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 9c25452..be30d02 100644 --- a/README.md +++ b/README.md @@ -81,10 +81,14 @@ 2. **务必为本次练习创建一条新分支**。 3. 确保本次 PR 不包含上一次练习的提交记录。 +-**注意事项**: +- 创建一个 issue,标题命名为 `Ex1` 或 `ex1` 或 `练习1` 或 `练习一`,机器人会将它分配给你,成为你的专属练习 issue +- 记得查看 [`CONTRIBUTING.md`](https://github.com/FrogDar/code-contributing-practice/blob/main/CONTRIBUTING.md) 里的规范(比如 git message 要使用 [`angular` 规范](https://github.com/angular/angular/blob/main/CONTRIBUTING.md)) + ## TODO - [x] 基本文字介绍 - [x] 完成第一个贡献流程 - [x] 完成一次手动评判 - [x] 利用 `GitHub Actions` 自动评判流程并给予提示 -- [x] 更为充实的文字介绍 +- [ ] 更为充实的文字介绍 From c3f70eabe29a8ae869d7dcea46a3fa5e775a51c6 Mon Sep 17 00:00:00 2001 From: cont1nu1ty <808535fm@gmail.com> Date: Thu, 16 Oct 2025 20:34:39 +0800 Subject: [PATCH 5/6] docs(README.md): i hav read this --- README.md | 6 +----- 1 file changed, 1 insertion(+), 5 deletions(-) diff --git a/README.md b/README.md index be30d02..098404d 100644 --- a/README.md +++ b/README.md @@ -71,7 +71,7 @@ - **步骤**: 1. 创建一个 Issue,标题为 `Ex1` 或 `练习一`,机器人会自动分配给你。 2. 严格遵循上述标准流程。 - 3. 遵守 `CONTRIBUTING.md` 中的规范(特别是 commit message 规范)。 + 3. 遵守 `CONTRIBUTING.md`(https://github.com/FrogDar/code-contributing-practice/blob/main/CONTRIBUTING.md) 中的规范(比如 git message 要使用[`angular` 规范](https://github.com/angular/angular/blob/main/CONTRIBUTING.md))。 ### 练习二:处理多个提交 @@ -81,10 +81,6 @@ 2. **务必为本次练习创建一条新分支**。 3. 确保本次 PR 不包含上一次练习的提交记录。 --**注意事项**: -- 创建一个 issue,标题命名为 `Ex1` 或 `ex1` 或 `练习1` 或 `练习一`,机器人会将它分配给你,成为你的专属练习 issue -- 记得查看 [`CONTRIBUTING.md`](https://github.com/FrogDar/code-contributing-practice/blob/main/CONTRIBUTING.md) 里的规范(比如 git message 要使用 [`angular` 规范](https://github.com/angular/angular/blob/main/CONTRIBUTING.md)) - ## TODO - [x] 基本文字介绍 From 55dfca3128b5aef2d189dbc4a9e134d243b321f2 Mon Sep 17 00:00:00 2001 From: cont1nu1ty <808535fm@gmail.com> Date: Thu, 16 Oct 2025 20:35:25 +0800 Subject: [PATCH 6/6] docs(README.md): i hav read this --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 098404d..e9556f8 100644 --- a/README.md +++ b/README.md @@ -71,7 +71,7 @@ - **步骤**: 1. 创建一个 Issue,标题为 `Ex1` 或 `练习一`,机器人会自动分配给你。 2. 严格遵循上述标准流程。 - 3. 遵守 `CONTRIBUTING.md`(https://github.com/FrogDar/code-contributing-practice/blob/main/CONTRIBUTING.md) 中的规范(比如 git message 要使用[`angular` 规范](https://github.com/angular/angular/blob/main/CONTRIBUTING.md))。 + 3. 遵守 [`CONTRIBUTING.md`](https://github.com/FrogDar/code-contributing-practice/blob/main/CONTRIBUTING.md) 中的规范(比如 git message 要使用[`angular` 规范](https://github.com/angular/angular/blob/main/CONTRIBUTING.md))。 ### 练习二:处理多个提交