docs: 更新 README 参与贡献部分内容

This commit is contained in:
2025-08-03 18:33:20 +08:00
parent cc7bb9cb70
commit a83d710b82
2 changed files with 21 additions and 21 deletions

View File

@@ -17,7 +17,7 @@ body:
required: true
- label: 查阅过 [使用指南](https://continew.top/admin/frontend/structure.html) 和 [常见问题](https://continew.top/admin/faq.html) ,仍然认为很有必要
required: true
- label: 查阅过 [需求墙](https://continew.top/admin/other/feature.html),仍没有该功能计划
- label: 查阅过 [需求墙](https://continew.top/admin/feature.html),仍没有该功能计划
required: true
- label: 搜索了项目 Issues没有其他人提交过类似的 Feature如果对应 Feature 尚未实现,您可以先订阅关注该 Issue为了方便后来者查找问题解决方法请避免创建重复的 Issue
required: true

View File

@@ -133,7 +133,7 @@ public class DeptController extends BaseController<DeptService, DeptResp, DeptDe
## 系统功能
> [!TIP]
> 更多功能和优化正在赶来💦,最新项目计划、进展请进群或关注 [需求墙](https://continew.top/admin/other/feature.html) 和 [更新日志](https://continew.top/admin/changelog/)。
> 更多功能和优化正在赶来💦,最新项目计划、进展请进群或关注 [需求墙](https://continew.top/admin/feature.html) 和 [更新日志](https://continew.top/admin/changelog/)。
> 功能不会用?请查看 [功能手册](https://continew.top/admin/function/tenant/management.html)。
- 仪表盘:提供工作台、分析页,工作台提供功能快捷导航入口、最新公告、动态;分析页提供全面数据可视化能力
@@ -341,39 +341,39 @@ continew-admin-ui
└─ README.md项目 README 文件,实际开发时替换为真实内容)
```
## 贡献指南
## 参与贡献
ContiNew Admin 致力于提供开箱即用持续舒适的开发体验。作为一个开源项目Creator 的初是希望 ContiNew Admin 依托开源协作模式,提升技术透明度、放大集体智慧、共创优秀实践,源源不断地为企业级项目开发提供助力。
ContiNewContinue New系列项目致力于通过持续迭代为开发者提供舒适的开发体验。作为开源社区我们的初是希望通过开源协作模式,提升技术透明度、放大集体智慧、共创优秀实践,源源不断地为企业级项目开发提供助力。
我们非常欢迎广大社区用户为 ContiNew Admin **贡献(开发,测试、文档、答疑等)** 或优化代码,欢迎各位感兴趣的小伙伴儿,[添加微信](https://continew.top/discussion.html) 讨论或认领任务。
我们诚挚邀请广大社区用户为 ContiNew 项目贡献力量,包括但不限于 Issue 排查、测试验证、代码开发与重构等。每一份贡献,都是推动项目进步的重要力量(请查阅 [贡献指南](https://continew.top/about/contributing.html))。欢迎各位感兴趣的小伙伴儿,[添加微信](https://continew.top/discussion.html) 讨论或认领任务。
### 分支说明
ContiNew Admin 的分支目前分为下个大版本的开发分支和上个大版本的维护分支PR 前请注意对应分支是否处于维护状态,版本支持情况请查看 [更新日志/版本支持](https://continew.top/admin/changelog/)。
ContiNew 系列项目采用清晰的分支策略,确保开发与维护有序进行。提交 PR 前,请确认目标分支是否处于活跃维护状态,版本支持情况请查看 [更新日志#版本支持](https://continew.top/admin/changelog/)。
| 分支 | 说明 |
| ----- | ------------------------------------------------------------ |
| dev | 开发分支,默认为下个大版本的 SNAPSHOT 版本,接受新功能或功能优化 PR |
| x.x.x | 维护分支,在 vx.x.x 版本维护期终止前(一般为下个大版本发布前),用于修复上个版本Bug,只接受已有功能修复,不接受新功能 PR |
| dev | 开发分支,用于下个大版本的 SNAPSHOT 开发,接受新功能或功能优化 PR |
| x.x.x | 维护分支,用于特定版本(如 vx.x.xbug 修复,仅接受已有功能修复 PR,不接受新功能 |
### 贡献代码
### 流程步骤
如果您想提交新功能或优化现有代码,可以按照以下步骤操作
若您希望提交新功能或优化现有代码,请遵循以下步骤:
1. 首先,在 Gitee 或 GitHub 上将项目 fork 到您自己的仓库
2. 然后,将 fork 过来的项目(即您的项目)克隆到本地
3. 切换到当前仍在维护的分支(请务必充分了解分支使用说明,可进群联系维护者确认
4. 开始修改代码修改完成后,将代码 commit 并 push 到您的远程仓库
5. Gitee 或 GitHub 上新建 pull requestpr选择好源和目标,按模板要求填写说明信息后提交即可(多多参考 [批准合并的 pr 记录](https://github.com/Charles7c/continew-admin-ui/pulls?q=is%3Apr+is%3Amerged),会大大增加批准合并率)
6. 最后,耐心等待维护者合并您的请求即可
请记住,如果您有任何疑问或需要帮助,我们将随时提供支持。
1. 在开源平台上将项目 fork 到您的个人仓库
2. 将 fork 的项目克隆到本地开发环境
3. 基于当前维护的分支(如 dev创建新分支如 feat/newFeature请勿直接修改源分支源分支仅做同步 ContiNew 最新代码用
4. 在新分支上进行代码修改完成后提交并 push 到您的远程仓库
5.开源平台上创建 pull request (PR),选择正确的源分支和目标分支,按模板填写说明信息参考 [已合并的 PR](https://github.com/continew-org/continew-admin/pulls?q=is%3Apr+is%3Amerged) 可提高合并率)
6. 提交 PR 后,系统会提示签署 CLA贡献者协议。请确保 commit 使用的邮箱与平台绑定邮箱一致(如果不一致,可以在本地通过 `git reset --soft HEAD~1` 回退,然后使用正确邮箱重新提交,最后 `git push -f` 即可,不需要重新创建 PR然后使用该邮箱签署即可
7. 耐心等待维护者审核并合并您的 PR建议通过交流群进行快捷沟通
8. PR 合并后,下次贡献前请先同步最新代码,再重复步骤 3 开始
> [!IMPORTANT]
> 欢迎大家为 ContiNew Admin 贡献代码,我们非常感谢您的支持!为了更好地管理项目,维护者有一些要求
> 为了确保项目质量和协作效率,请注意以下事项
>
> 1. 请确保代码配置文件的结构命名规范良好,完善的代码注释
> 2. 提交代码前,请按照 [Angular 提交规范](https://github.com/conventional-changelog/conventional-changelog/tree/master/packages/conventional-changelog-angular) 编写 commit message
> 1. 代码配置文件请参考已有风格,遵循清晰的结构命名规范,提供完善的注释
> 2. 提交,请按照 [Angular 提交规范](https://github.com/conventional-changelog/conventional-changelog/tree/master/packages/conventional-changelog-angular) 编写 commit message(参考已有风格)
## 反馈交流