感谢你愿意为 Exercism 贡献一份力量! 在创建拉取请求之前,请先阅读如何做出优秀的拉取请求指南。这份指南旨在帮你处理拉取请求中非技术性的部分,让你获得良好的体验,同时也帮到我们的维护团队。
本文还包含一些针对不同类型拉取请求的、Exercism 特有的补充指南。
围绕概念练习和实践练习有很多规则,为它们创建拉取请求可能会让人望而却步。 因此,维护者可能要花两到三个小时来评审,还可能产生几十条评论。 为了帮助你,会有一位主评审人来评审并评论你的拉取请求。
不要因为评审意见的数量而气馁。一个练习经过多次重写,最终达到你和主评审人都满意的程度,这是再正常不过的事。
以下建议能帮你进一步简化流程。
在为练习创建拉取请求之前,务必阅读概念练习文档或实践练习文档。 事先阅读文档会有很大帮助:评审意见会更少,你的拉取请求也能更快被合并。
如果该赛道已有一些练习,花点时间研究一下它们,看看它们长什么样、是如何组织的。
实践练习的部分内容(比如简介)来自它在 problems-specifications 仓库中定义的(共享)元数据。 如果你打算更新这类内容,先想一想这个改动是否也能让其他赛道受益。 如果是,请改为向 problems-specifications 仓库中该练习的元数据提交拉取请求。
所有拉取请求评审都由该赛道的一位(或多位)维护者完成,因为他们负责批准对代码仓库的所有更改。 由维护者来评审,也有助于避免给拉取请求作者带来互相矛盾的意见。
当然,欢迎你留言为评审提供帮助(尤其是较大的拉取请求),或者在你发现疑似错误的地方提出问题。