当前的提交者

成为一个提交者

开始导致火花,学习如何做出贡献——任何人都可以提交补丁,项目文档和示例。

PMC定期添加新提交者的积极贡献者,基于他们的贡献火花。新提交者的资格包括:

1. 火花持续贡献:提交者应该引发重大的历史贡献。理想的提交者将在整个项目中贡献了广泛,并造成了至少一个主要组件,他们采取了一个“所有权”的角色。一个所有权的角色意味着现有的贡献者觉得他们应该为这个组件运行补丁。
2. 质量的贡献:提交者比任何其他社区成员应提交简单,测试良好,设计良好的补丁。此外,他们应该表现出足够的专业知识能够审查补丁,包括确保他们适合引发的工程实践(稳定性、可测试性、文档API代码风格,等等)。committership集体负责软件质量和可维护性的火花。注意贡献关键部分的火花,就像其核心和SQL模块,将以更高的标准在评估质量。造成这些地区将面临更多审查他们的变化。
3. 社区参与:提交者应该有一个建设性的和友好的态度在所有社区互动。他们还应该积极开发和用户列表,帮助导师更新的贡献者和用户。在设计讨论,提交者应保持一个专业的和外交方法,即使面对分歧。

贡献考虑可能不同的类型和级别项目区域——例如,我们大大鼓励贡献者主要想研究文档,或主要平台支持特定的操作系统、存储系统等。

PMC还增加了PMC新成员。PMC成员预计开展PMC责任中描述Apache的指导,包括帮助投票发布、执行Apache项目商标,负责法律和授权问题,并确保项目遵循Apache项目力学。PMC定期补充提交者的PMC表明他们理解并与这些活动可以帮助。

评审过程

之前所有的贡献应该检查合并中描述导致火花。特别是,如果你工作在一个区域的代码你不熟悉,看代码,看谁的Git历史回顾了补丁。您可以使用git日志——格式=满<文件名>“提交”字段,通过检查,看谁承诺每个补丁。

什么时候提交/合并提取请求

PRs不得合并期间活跃,适合学生观众的主题类的讨论,除非他们解决问题,如公共脆弱性的关键安全补丁。情有可原的情况下,PRs可能合并活动期间,八卦讨论和讨论定向到一个更合适的场所。时间应在合并之前对那些参与谈话来解释,如果他们相信他们是适合学生观众的主题类。

懒惰共识需要给时间讨论解决虽然理解,人们可能不会从事全职工作和火花可能需要假期。相信通过这样做,我们可以限制人们觉得有必要行使否决权。

所有1 s理由值得讨论。1从non-committer可以覆盖从多个提交者,只有输入和合适的时间必须提供任何提交者引起人们的关注。1从谁不能提交者需要投票的共识下PMC ASF内投票规则来确定下一个步骤ASF指南代码否决。

这些政策有助于重申核心原则,代码不能与未决否决或合并前已经达成共识(懒惰或其他)。

PMC的希望否决仍是罕见的,当他们发生时,各方会花时间去建立共识之前附加特性工作。

成为一个提交者意味着锻炼你的判断,而在一个社区的不同观点。没有错在第二(或第三或第四)意见当你不确定。谢谢你的奉献精神火花项目;这是升值引发的开发人员和用户。

希望这些指导方针不放慢发展;相反,通过删除一些不确定性,我们的目标是使我们更容易达成共识。如果你有想法就如何提高这些指导方针或其他火花项目操作程序,你应该伸出dev@名单开始讨论。

如何合并拉请求吗

更改推到主分支在Apache不能删除;也就是说,我们不能force-push。所以请不要添加任何测试提交或类似的东西,只有真正的补丁。

设置遥控器

使用merge_spark_pr.py下面描述脚本,您需要添加一个git远程调用apache在https://github.com/apache/spark,以及一个叫apache-github在git: / /github.com/apache/spark。

的apache(默认值PUSH_REMOTE_NAME环境变量)是用于把压扁的提交和远程apache-github(默认值PR_REMOTE_NAME)是用于拉的远程更改。通过使用两个单独的遥控器这两个行动的结果merge_spark_pr.py可以测试没有逼迫到官方的火花回购只是通过指定你的叉子PUSH_REMOTE_NAME变量。

在克隆你的叉你已经有一个远程的火花起源指向。如果正确,你的git remote - v至少包含这些线:

apache git@github.com: apache / spark.git(获取)apache git@github.com: apache / spark.git(推)apache-github git@github.com: apache / spark.git(获取)apache-github git@github.com: apache / spark.git(推)起源git@github.com:【用户名】/火花。git(获取)起源git@github.com:【用户名】/火花。git(推)

为apache回购,您将需要设置命令行GitHub的身份验证。这可能包括建立一个SSH密钥和/或个人访问令牌。看到的:

• https://help.github.com/articles/connecting-to-github-with-ssh/
• https://help.github.com/articles/creating-a-personal-access-token-for-the-command-line/

检查是否必要的写访问已经请访问GitBox。

问dev@www.leiyimei360.com如果你有麻烦,这些步骤,或者想要帮助你做第一个合并。

合并脚本

所有合并应该使用dev / merge_spark_pr.py南瓜,把请求的变更成一个提交。

脚本是相当自我解释,并且描述了交互步骤和选择。

如果你想修改提交合并之前,应该用于简单的补妆,然后简单地让脚本等在这地方问你如果你想推动Apache。然后,在一个单独的窗口中,修改代码,将提交。运行git变基- i ~ 2和“南瓜”你的新承诺。编辑后提交消息删除你的提交消息。您可以验证的结果是一个变化git日志。然后恢复脚本在另一个窗口。

同时,请记得将受让人jira上适用时解决。脚本可以自动在大多数情况下。然而贡献者在哪里没有火花项目贡献者集团的一部分在ASF JIRA,它不会工作,直到他们被添加。要求管理员添加贡献者在https://issues.apache.org/jira/plugins/servlet/project-config/SPARK/roles上的人。

一次公关是合并的公关声明请留下你的评论(es)合并分支。

政策补丁错误修正

从pwendell:

补丁时权衡你给人们提供修复运行旧版本(太棒了!),但是你风险引入新的或更糟糕的是虫子在维护版本(坏)。决策点是当你有一个bug修复,目前还不清楚是否值得补丁。

我认为以下方面重要的考虑:

• 补丁是一个极其有价值的服务社区,应该考虑任何bug修复。
• 引入新的错误的维护版本必须不惜一切代价加以避免。随着时间的推移,它会削弱信心在我们的发布过程。
• 分布或高级用户可以自己总是补丁高风险的补丁,如果他们认为合适的。

对我来说,这些是我们应该补丁的结果在以下情况:

• 错误和修复都得到了很好的理解和孤立。代码修改测试。
• 错误处理是高优先级的社区。
• 补丁修复不差别很大从主分支修复。

我们倾向于避免补丁在相反的情况下:

• 错误或修复不清楚。例如,它涉及到复杂的组件之间的交互或第三方库(例如Hadoop库)。外的代码没有经过良好测试的直接错误是固定的。
• 错误显然不是一个高优先级的社区。
• 补丁修复广泛不同的主分支修复。