为开源做出贡献的惯例

moni2340800

这是 SitePoint 的开源周！整个星期我们都在发布专注于开源、免费软件和社区的文章，因此请继续查看最新更新。 开源 本文由Thom Parkin进行同行评审。感谢所有 SitePoint 的同行评审者使 SitePoint 内容达到最佳状态！ 目录 导游 行为守则 报告错误/问题 安全问题 所有其他问题 功能请求 帮助解决现有问题 为 Rails 文档做出贡献 翻译文档 贡献源代码 设置本地环境 编写代码 源代码控制约定 编码约定 测试代码 记录变更 依赖管理 提交变更 分叉和拉取请求 讨论和迭代 向后兼容性和向后移植 结论 评论 我们都喜欢使用开源，对吧？我为开源做出了应有的贡献，主要是通过各处的小贡献。我过去曾尝试开源一些库，取得了不同程度的成功和失败。我想说我处于贡献者光谱的中间位置。有些人做得更多，有些人做得更少。


如果您有兴趣成为 OSS 贡献者，那么关于如何做到这一点的文章并不缺乏。事实上，几年前我自己写了一篇。我将把一步一步的贡献留给那些有能力的人。 今天，我想重点谈谈开源贡献的一些约定，从开源创建者的角度来看待它。我这次旅程的工具是 Rails 贡献指南。众所周知，Rails 是一个非常 象牙海岸 WhatsApp 号码列表 非常成熟的框架，也是一项巨大的开源事业，由许多模块和数千名贡献者组成。由于围绕创建和维护 Rails 的所有这些活动，贡献者使用的文档和约定必须全面且格式良好。 换句话说，我觉得 Rails 在开源软件如何创建贡献指南方面是一项很好的研究。让我们看看我是否正确。 导游 正如我提到的，我们将基本上浏览“为 Ruby on Rails 做出贡献”指南，抽出并讨论 Rails 做出贡献的方法。以下是指南开头的主要要点： 如何使用 GitHub 报告问题。



如何克隆 master 并运行测试套件。 如何帮助解决现有问题。 如何为 Ruby on Rails 文档做出贡献。 如何为 Ruby on Rails 代码做出贡献。 这就是指南作者认为对贡献者来说最重要、最高级的项目。让我们看看他们如何应对每一个问题。 行为守则 不过，在此之前，我想指出 Rails 确实有正式的行为准则 (CoC)。无论您是否同意存在或需要这样一份文档，Rails 都会提供一份。因此，贡献者应遵守 CoC。当您决定成为开源贡献者时，这给我带来了一个重要的考虑因素。 如果您打算开源自己的创作，您应该仔细考虑 Rails CoC 中提出的问题。 CoC 通常是一个两极分化的问题，因此您是否选择拥有一个 CoC 及其内容非常重要。您将如何处理投诉？如果您觉得有人骚扰或不尊重您作为您贡献的一部分，您该怎么办？确保您了解您的期望和社区的期望。