Bylx666 / key-lang

目标是最精致的编程语言
https://docs.subkey.top
Mozilla Public License 2.0
112 stars 4 forks source link

[建议] 使用 Github 的一些特性来更好的维护本项目的 git 记录 #20

Open qwedc001 opened 4 months ago

qwedc001 commented 4 months ago

原因:这更像是一个基础的原则性问题。因为所有的项目,既然开源,在作者做出指向性修改的时候,都应该标定修改的位置,并在问题界面提供明确的入口,方便其他人进行 review,以及其他的操作。

修改建议:在进行 commit 的时候,加入 issue 编号来标定该 commit 用于修复哪项 issue。

原因:我承认,在单人进行开发的时候,可能开启 main branch protect 并采取 branch merge 听上去有点自娱自乐,但是事实上这个能帮助你更好的进行版本控制。假如你后续写了两个功能,先写的功能 A 再写的功能 B,然后再加入一个功能 C 发现功能 A 会导致功能 C 出现问题,如果需要 revert 排查,使用 branch merge 就可以迅速的帮你关闭功能 A。按照你现有的方法,出现 bug 时回滚会导致功能 B 一块下线。修复结束后再加入功能 B 则会污染现有的 git 记录。

修改建议:开启 main branch protect 并在后续的开发中采取开 branch 开发的模式。

原因:一个好的 README 应该绝不只是包含你认为你写的程序的特色,对于编程语言类库而言,可以参考 wenyan-lang/wenyan 项目。他们的 README 是非常用语言 README 中我认为最好的一个。

修改建议:你自己看着改。

Bylx666 commented 4 months ago

请不要写免责声明. 我非常欢迎礼貌交流, 我认可你的issue.