NitWikit/CONTRIBUTING.md

52 lines
2.3 KiB
Markdown
Raw Permalink Normal View History

2024-07-14 10:43:59 +08:00
# 为笨蛋文档做出贡献
2024-08-27 10:57:34 +08:00
首先,感谢你抽出宝贵时间做出巨大贡献!!
2024-07-14 10:43:59 +08:00
2024-08-27 10:57:34 +08:00
所有类型的更改都会最大限度通过,但在此之前,你需要先阅读以下几点来加快审核进度
2024-07-14 10:43:59 +08:00
## 目录
2024-07-14 11:27:57 +08:00
- [这篇文档有问题](#这篇文档有问题)
- [我想要为文档做出贡献](#我想要为文档做出贡献)
- [格式要求](#格式要求)
- [尽量使用个人分叉而不是组织分叉](#尽量使用个人分叉而不是组织分叉)
- [感谢](#感谢)
2024-07-14 10:43:59 +08:00
## 这篇文档有问题
2024-08-27 10:57:34 +08:00
由于此文档由大量人员共同编辑,难免会有瑕疵,如果你发现了文档中的问题之处,请按照以下方法提交:
2024-07-14 10:43:59 +08:00
- 打开 [ISSUE](https://github.com/postyizhan/NitWikit/issues)
2024-08-27 10:57:34 +08:00
- 查看是否有相似问题,无论其处于打开状态还是关闭状态
2024-07-14 10:43:59 +08:00
- 尽可能详细地提出出错的地方和问题详情
2024-08-27 10:57:34 +08:00
然后,我们将尽快处理该问题
2024-07-14 10:43:59 +08:00
## 我想要为文档做出贡献
2024-08-27 10:57:34 +08:00
我们不接受任何无意义或偏离主题的意见,所以你应当说明此更改的合理性,并且你应当在提交更改前查看是否有类似更改
2024-07-14 10:43:59 +08:00
你也可以提供针对[待办事项](https://github.com/postyizhan/NitWikit/blob/main/docs/contribution/todos.md)中未完成事项的更改来提高通过的几率
2024-08-27 10:57:34 +08:00
记住!你的任何更改不止会影响到你,还有其他需要通过这篇文档来搭建服务器的人
2024-07-14 10:43:59 +08:00
2024-08-27 10:57:34 +08:00
我们可以在你说明未排版的前提下代替你进行排版,但在此之前,请遵循以下要求:
2024-07-14 10:43:59 +08:00
### 格式要求
2024-08-27 10:57:34 +08:00
对于文档,我们有格式要求,详见 [格式要求](https://github.com/postyizhan/NitWikit/blob/main/docs/contribution/writing-specification/writing-specification.md)
2024-07-14 10:43:59 +08:00
2024-08-27 10:57:34 +08:00
若格式不规范但不会或不想排版时请在 PR 时提出**文档需排版**,否则我们极大概率会关闭此处更改
2024-07-14 10:43:59 +08:00
### 尽量使用个人分叉而不是组织分叉
2024-08-27 10:57:34 +08:00
我们可能会在一些极端情况下去修改你的分叉,无论是解决大量冲突还是修改错误,这比你自己来回检查要快速且方便的多
2024-07-14 10:43:59 +08:00
2024-08-27 10:57:34 +08:00
问题是,如果你是组织分叉,我们无法将对其进行更改,_详见 isaacs/github#1681_ ,这会导致我们会关闭它并手动合并,而不是被标记为合并
2024-07-14 10:43:59 +08:00
_我们更加希望它会显示为合并而不是被关闭_
#### 感谢
感谢 [contributing-gen](https://contributing.md/) 生成的模板