MCSManager/CONTRIBUTING.md

50 lines
2.6 KiB
Markdown
Raw Normal View History

2024-04-18 11:45:02 +08:00
## English 🌎
### Purpose
2024-04-18 14:46:19 +08:00
To prevent uncontrolled growth of features and wasted effort after submitting PRs that are not merged, these notices are hereby written.
2024-04-18 11:45:02 +08:00
2024-04-18 14:46:19 +08:00
### Submitting New Features
2024-04-18 11:45:02 +08:00
2024-04-18 14:46:19 +08:00
If you wish to submit a new feature via a Pull Request, please first open an issue to inform the developer @unitwk. After discussion, we will decide together whether the feature should be developed.
2024-04-18 11:45:02 +08:00
2024-04-18 14:46:19 +08:00
We will consider whether to merge this feature into the master branch from three perspectives: `scope of code impact`, `practicality of the feature`, and `estimated number of applicable users`.
2024-04-18 11:45:02 +08:00
2024-04-18 14:46:19 +08:00
Otherwise, unrestrained addition of features will inevitably lead to the continuous bloating of software functionality, which will sooner or later result in very serious security vulnerabilities.
2024-04-18 11:45:02 +08:00
2024-04-18 14:46:19 +08:00
### Iterating Old Features
2024-04-18 11:45:02 +08:00
2024-04-18 14:46:19 +08:00
Fixing or upgrading an existing feature, **without exceeding the responsibilities of the old feature**, **does not require opening an issue for discussion**. You can directly submit a Pull Request, and after testing and Code Review, it will be merged.
2024-04-18 11:45:02 +08:00
2024-04-18 14:46:19 +08:00
**Code in open-source projects often exists for several years or even decades. Due to differences in developer habits, implementation approaches, and code styles, we need some rules and constraints to ensure the long-term health of the code. Thank you for your understanding.**
2024-04-18 11:45:02 +08:00
2024-04-18 14:46:19 +08:00
### How to Contribute Code?
2024-04-18 11:45:02 +08:00
2024-04-18 14:46:19 +08:00
Please refer to the `Development` section in the README.md file.
2024-04-18 11:45:02 +08:00
<br />
## 中文 🌏
### 目的
为了防止功能无节制增长和提交 PR 之后未得到合并浪费工作精力,特此写下这些须知通告。
### 提交新功能
2024-04-18 14:46:19 +08:00
如果你想 `Pull Request` 一个新功能,请先开启一个 `issue` 告知开发者 @unitwk ,我们一起经过讨论之后,再决定这个功能是否应该开发。
2024-04-18 11:45:02 +08:00
我们会从`代码影响范围``功能实用性`和`估算的适用群体人数` 三个角度来考虑这个功能是否应该合并到 master 分支。
2024-04-18 14:46:19 +08:00
否则,无节制的新增功能必将导致软件功能不断臃肿,从而迟早会有一天会出现非常严重的安全漏洞。
2024-04-18 11:45:02 +08:00
### 迭代旧功能
修复或升级某个现有的功能,在**不超出旧功能的职责**情况下,**无需开 `issue` 进行讨论**,你可以直接提交 `Pull Request`,在经过测试和 `Code Review`后,都会给予合并。
**开源项目的代码通常会存在几年甚至十年以上,由于每个开发者习惯不同,实现思路不同,代码风格不同,所以我们需要有一定的规则约束来让代码长期健康的活下去,谢谢你的理解。**
2024-04-18 14:46:19 +08:00
### 如何贡献代码?
请阅读 README.MD 文件的 `Development` 段落。