From f1a5d6dc1ebdb312daffc0dc702e993b3b0f0d3d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=98=BF=E5=9F=BA=E7=B1=B3=E4=B8=9C?= <870179822@qq.com> Date: Sat, 13 Apr 2024 11:25:25 +0000 Subject: [PATCH] =?UTF-8?q?update=20=E7=AC=AC=E5=9B=9B=E9=83=A8=E5=88=86?= =?UTF-8?q?=EF=BC=9A=E5=90=AF=E5=8A=A8=E8=87=AA=E5=B7=B1=E7=9A=84=E5=BC=80?= =?UTF-8?q?=E6=BA=90=E9=A1=B9=E7=9B=AE/=E7=AC=AC=206=20=E5=B0=8F=E8=8A=82?= =?UTF-8?q?=EF=BC=9ACONTRIBUTING=20=E7=BC=96=E5=86=99.md.=20=E5=A2=9E?= =?UTF-8?q?=E5=8A=A0=E6=96=87=E7=AB=A0=E5=BC=80=E5=A4=B4=EF=BC=8C=E4=BC=98?= =?UTF-8?q?=E5=8C=96=E6=96=87=E7=AB=A0=E6=A0=BC=E5=BC=8F?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: 阿基米东 <870179822@qq.com> --- ...2CONTRIBUTING \347\274\226\345\206\231.md" | 33 ++++++++++++------- 1 file changed, 21 insertions(+), 12 deletions(-) diff --git "a/\347\254\254\345\233\233\351\203\250\345\210\206\357\274\232\345\220\257\345\212\250\350\207\252\345\267\261\347\232\204\345\274\200\346\272\220\351\241\271\347\233\256/\347\254\254 6 \345\260\217\350\212\202\357\274\232CONTRIBUTING \347\274\226\345\206\231.md" "b/\347\254\254\345\233\233\351\203\250\345\210\206\357\274\232\345\220\257\345\212\250\350\207\252\345\267\261\347\232\204\345\274\200\346\272\220\351\241\271\347\233\256/\347\254\254 6 \345\260\217\350\212\202\357\274\232CONTRIBUTING \347\274\226\345\206\231.md" index 3a8d5d2..335de98 100644 --- "a/\347\254\254\345\233\233\351\203\250\345\210\206\357\274\232\345\220\257\345\212\250\350\207\252\345\267\261\347\232\204\345\274\200\346\272\220\351\241\271\347\233\256/\347\254\254 6 \345\260\217\350\212\202\357\274\232CONTRIBUTING \347\274\226\345\206\231.md" +++ "b/\347\254\254\345\233\233\351\203\250\345\210\206\357\274\232\345\220\257\345\212\250\350\207\252\345\267\261\347\232\204\345\274\200\346\272\220\351\241\271\347\233\256/\347\254\254 6 \345\260\217\350\212\202\357\274\232CONTRIBUTING \347\274\226\345\206\231.md" @@ -1,16 +1,14 @@ # 第 6 小节：CONTRIBUTING 编写 -## CONTRIBUTING 是什么 - -> ​ CONTRIBUTING 文件用来告诉人们如何对项目做出贡献. +CONTRIBUTING 是开源项目中的一个重要文件，它的作用是告诉用户和开发者如何对项目做出贡献。本节我们将介绍如何为你的项目编写一个好的 CONTRIBUTING 文件，让更多人参与到那你的项目。 ## CONTRIBUTING 如何编写 在 **CONTRIBUTING** 文件中会含有下面这些主题的内容（可能不完整, 请各位读者进行补充） 1. 如何提交错误报告 - 1. 当出现 Bug 的时候需要如何提交，对于安全性的漏洞需要通过项目内部的人员邮箱通知， 不应该将安全性 Bug 公开 - 2. 通过 Issues 仅提交 + - 当出现 Bug 的时候需要如何提交，对于安全性的漏洞需要通过项目内部的人员邮箱通知，不应该将安全性 Bug 公开。 + - 通过 Issues 仅提交。 2. 解决现有问题 3. 如何提出新功能 4. 如何设置开发环境并运行测试 @@ -19,44 +17,55 @@ 7. 分支处理的约定 8. 合并 PR 的形式 -### 例子 +### 示例 -```md +```markdown ## 提交错误报告 + 如果您在XXX中发现了一个不存在安全问题的漏洞, 请在XXX仓库中的 Issues 中搜索, 以防该漏洞已被提交, 如果找不到漏洞可以创建一个新的 Issues. 如果发现了一个安全问题请不要将其公开. 请参阅安全问题处理方式. 提交错误报告时应该详尽 ## 安全问题处理 + 本项目中对安全问题处理的形式. 项目核心人员确认编辑. 该部分内容可以根据项目情况添加 ## 解决现有问题 + 通过查看仓库的 Issues 列表何以发现需要处理的问题信息, 可以尝试解决其中的某个问题 ## 如何提出新功能 + 提出新功能有些项目使用 Issues 的 Feature 标签进行管理, 有些则通过邮件的形式统一收集. 在收集后项目内人员会进行确认开发, 一般的将确认开发的功能会放入下一个版本的任务列表 ## 如何设置开发环境并运行测试 + 如果是通过 Git 管理可以从 `git clone xxx` 开始编写, 将开发环境的配置信息, IDE 的设置等信息配置文档编写. -## 变更日志填写规则 +## 变更日志填写规则 + 1. 使用现在时态 1. 第一行字数限制 1. 提交内容的约束 ## 编码约定 + - 项目内编码约定文件, .editorconfig ## 分支处理约定 + - 分支处理形式, 如 gitFlow ## 合并 PR 的形式 + 在什么情况下可以合并到 master/main. - 1. 通过 CI - 2. 两个及以上的维护者通过. - 3. 最新版本 + +1. 通过 CI +2. 两个及以上的维护者通过. +3. 最新版本 + ``` ### 本部分内容贡献者 -[huifer](https://gitee.com/pychfarm_admin)、[PureBlue](https://gitee.com/qq379377944)、[taotieren](https://gitee.com/taotieren)、[WhitePaper](https://gitee.com/whitepaper233)、[yadong.zhang](https://gitee.com/yadong.zhang) +[huifer](https://gitee.com/pychfarm_admin)、[PureBlue](https://gitee.com/qq379377944)、[taotieren](https://gitee.com/taotieren)、[WhitePaper](https://gitee.com/whitepaper233)、[yadong.zhang](https://gitee.com/yadong.zhang)、[阿基米东](https://gitee.com/luhuadong) > 发现内容中的错误？还是想要补充更多符合主题的内容？《开源指北》欢迎你进行贡献，点击[贡献指南](./../贡献指南.md)了解贡献的具体步骤。 \ No newline at end of file -- Gitee