贡献的指导方针

我们负责所有的开发工作GitHub上.如果你不熟悉GitHub或pull requests,这里有一个很好的入门指南

发现一个问题

这里有一个列表我们目前所有的项目.我们使用与每个项目相关的GitHub问题来跟踪与该项目相关的工作。在那里你可以找到需要做的事情。

我们广泛使用问题标签来指定各种问题的优先级、状态和初学者友好性。我们在所有项目中都有一套标准的标签,记录在这里.下面是一些与找到一个好问题最相关的建议:

  • 可供社区贡献的问题:
    • 下面的标签标记了开放给社区贡献的问题:
      • 招聘:对社区的参与开放,但不一定对初学者友好
      • 良好的第一问题:开放社区的参与,并对新的贡献者友好
    • 您不需要我们的许可就可以处理这些问题。
    • 你可能会在一个标有良好的第一问题即使这不是你的第一期。
  • 无法供社区贡献的问题:
    • 以下标记标记的问题开放给社区捐款:
      • 工作人员只:需要使用基础设施或机构知识,而这些知识无法提供给社区
    • 不要做这些。
  • 未准备工作的问题:
    • 以下标记标记的问题开放给社区捐款:
      • 状态:阻塞:被其他需要先完成的工作所阻塞
      • 状态:需要票务工作:在准备好接受之前需要额外的工作
      • 状态:等待分流:没有被维护人员分类
    • 不要做这些。
  • 没有任何上述标签的问题:
    • 这些问题五月(或可能不)开放供捐款。
    • 请添加一个注释,要求一个维护人员对问题进行分类,并适当地对其进行标记。

你可以使用我们的问题搜索工具找到与您的技能和对我们的软件和社区的熟悉程度相匹配的好问题。

在GitHub上保存了一些有用的搜索,可以帮助找到问题:

检查问题评论/标签,看看是否有人表示他们正在处理它。如果有人已经在做这个问题,并且在过去7天内已经有了活动,你可能想要找一个不同的问题来做。

贡献流程

一旦你找到了你想要解决的问题,请按照以下步骤做出贡献:

  1. 评论一下,说你正在解决这个问题。这是为了避免与其他同样在处理这个问题的人发生冲突。如果你已经遵循了上面的指导方针,你就不需要请求允许就可以开始处理一个问题。
  2. 编写代码并提交pull request。一定要阅读并关注我们的把请求指导方针
  3. 等待代码审查,并尽快解决所提出的任何问题。

关于合作的说明:我们鼓励人们尽可能多地合作。我们特别感谢贡献者审查彼此的拉请求,只要你是善良的和建设性的当你这样做的时候。

提出新议题

如果你想做一些没有GitHub问题的东西,请遵循以下步骤:

  1. 创建一个与相关存储库相关的新的GitHub问题,并在那里提出您的更改。一定要包括实现细节和提议的更改的基本原理。
    • 我们非常不愿意接受没有相关问题的随机拉请求。
  2. 该问题将自动有状态:等待分流标签应用。等待项目维护者评估您的问题,并决定是否我们将为此接受pull请求。
  3. 一旦项目维护者批准了问题并删除了状态:等待分流标签,你可以开始工作的代码描述在“贡献过程”一节上面。

当有疑问时,问一个问题我们的社区论坛之一

捐款

对创作共用开放源码的经常性捐款可以通过卡塔尔vs葡萄牙分析在GitHub上赞助@ creativcommons