不同的开源社区工作是不同的,所以每个人都可能到达Creative Commons的项目和自己的个人期望。卡塔尔vs葡萄牙分析有人可能认为直接提交拉请求一个项目没有问题。或者他们可能提交一个问题,然后立即一个关联的请求。在知识卡塔尔vs葡萄牙分析共享过程我们希望跟有机会考虑,社区参与和讨论。我们协作,良好的文档记录和通知工作更多的可能!
事物通常从一个想法开始新的功能,新的/修改文档,或者遇到了各种各样的错误。这一想法或错误然后捕获是一个GitHub问题用来描述它的细节。认为这是在实施之前的抽象。
重要的是要首先通过现有的问题,包括那些已经关闭以确定别人已经一个重叠的问题。如果他们有,最好添加你所发现的任何新信息或认为是评论(或一系列的评论)的问题,而不是创建一个新的。
错误(通常称为bug)应该验证,和可再生的如果可能的话。截图,步骤来复制,视频,和环境细节都非常有利于其他人当他们想检查错误。所有的信息收集和放置在一个简洁的,但具体问题相关的库。值得注意的是,记录问题本身是一个有价值的贡献。它将提供指导和文档谁解决工作或实现它,所以它是一样重要的最终将写的代码。这意味着它应该做得很好,因为更好的问题描述错误和繁殖提供了明确的方式对任何人来说就越容易解决这个问题。
功能和特性的建议往往是更多的参与。错误有些失常的现有或预期功能代码库的状态,但新的/修改功能或特性引入更大的规划方面的考虑。他们必须考虑事物的现状和提出未来状态他们引入一个问题。这是一个锻炼沟通和描述首先,这意味着有一个详细的那样,线框,模型,和证据来支持它成功的建议是至关重要的。错误的地方可以考虑修复一套更加孤立的后果,引入新特性/功能可能产生意想不到的副作用,它可能需要多个部分的代码被修改或改变。所有这些大图考虑应该考虑和解决的问题。应当期望平均特性问题可能需要更长的时间来介绍,和更长的时间来充分文档是清晰、简洁的方法重点在其他社区。
文档可以使用改进是否在代码注释,一个项目的自述。医学博士,或者相关的文档。这将在很大程度上被视为一个“功能问题”技术,但值得指出它们分别因为他们一样重要,如果不是更多,比修正错误或添加代码库的功能水平。好的文档使项目强和社区更明智。这里应该改进文档的差距或需要修改的地方,以及他们如何应当予以纠正。
是否一个错误或特性/功能问题,一旦它被提交,依照贡献的指导方针,它将移动到“等待分流”的地位。这意味着它是等待审查的核心代码贡献者之一。虽然在这个国家没有实现工作应该做(没有PRs,没有代码工作添加或正确的行为)。提交一个问题在很大程度上是一个过程的开始,和一个对话。核心贡献者将审查这一问题,看看它是否充分描述其适当的细节,如果其目标适合更大的模式和目标代码本身。完全有可能通过深思特性问题,增加了一些新的菜单功能是孤立的一个好主意,但它并不适合项目的目标问题,不会前进。没关系,即使一个问题没有前进它现在可以站作为社区文档不会在这个时候,什么什么一样重要。的贡献是否前进,只要它自称。
如果发生这种情况,这一问题将移动到“丢弃”的地位,并与评论解释了为什么将被关闭。另一个原因可能是一个问题搬到“丢弃”在另一个问题是重复的工作,这就是为什么重要的是要首先检查所有现有的问题之前提交一个新的。
有时问题可能描述的东西比可以很容易地包含在更广泛,可以转换为“讨论”的地位。这意味着这个问题应该引起更大的谈话在社区内的角度考虑所有抽象,甚至把这个想法分成多个问题更容易管理的部分。其他的结果可能是一个讨论时意识到的想法是合理的,它不是可实现在这个时间和不会前进。
一些问题是固体的想法,但他们是不可以在其他问题上向前移动,直到工作完成。这样他们会搬到一个“阻塞”的地位。他们会坐在状态直到他们疏通和工作可能发生。
如果一个问题似乎没有足够的信息来确定如何处理它,那么它可能会搬到一个“票工作要求”的地位和评论通常会描述需要工作。
记住,一个问题是文档的一种形式,在某种程度上这是一个谈话,这意味着直到它推进一项正在进行中的工作。
如果一个问题经过这段时间是可实现的,那么它将搬到一个“准备工作”的地位。在这一点上它可以实现,和一个贡献者可以提交拉请求解决。(见库标签状态部分更多信息)
在这个过程中值得注意的是,将会有多种类型的贡献。例如:
- 这个问题本身是一个贡献
- 评论这个问题来自社区的精炼是每一个贡献
- 别人的评论帮助他人解决问题为什么错误的发生是一个贡献。
- 有人发现另一个相关问题并链接相关问题是一个贡献。
所有这些贡献发生之前拉曾经发起请求。一旦一个问题进入“准备工作”地位的人利息表示,问题将会分配给它,然后叉存储库,让部门内工作,一旦提交将请求解决。仅这一过程可能涉及一些贡献,例如:
- 代码工作遇到一个问题,有人问寻求帮助在他们起草公关,和几个成员提供帮助的评论。
- 有人评论最后的公关和树叶详细审查可能需要解决
- 讨论爆发的最好方法解决一个公关遇到问题,这些评论是一个贡献
- 当然,公关本身是一个贡献。
如果公关通过审查,那么它将标记为批准合并到代码库,将触发相关的问题关闭完成现在的错误修复或功能问题将完全实现到这个项目中。
到这里花了多贡献,从不同的社区成员,这是开源的力量!