云萌主云应用官方论坛

标题: 【转载】不做这7件事，你就是有效的OpenStack贡献者 [打印本页]

作者: 粉萌心愿 时间: 2017-1-23 10:41
标题: 【转载】不做这7件事，你就是有效的OpenStack贡献者
有许多博客和资源为新的和有抱负的OpenStack贡献者提供提示，列出该做什么。可如果你想成为一个有效的OpenStack贡献者，有7件事要避免。

在过去三年，我看到几个新手级别的错误重复出现，我认为应该记录这些“不要做”的事情。以下就是我认为七个不应该做的事情（如果你想成为一个有效的OpenStack贡献者）。

1.不提交空的commit message

commit message是提交的一个有用的部分，它用于通知审阅者有关更改是什么，以及你所建议的修复如何解决该问题。一般来说，（发布或基础设施等程序性提交例外），commit message不应该为空。只写“Trivial Fix”远不够。

OpenStack记录了commit message的最佳实践。确保commit message提供了该问题的简明描述，以及你建议如何解决它，并包括一个引用（通过Close-Bug、Partial-Bug 或 Related-Bug标签）到问题的Launchpad。

2.不要期望审阅是自动的

在OpenStack中，审阅更改是一个社区活动。如果你提出更改，这些更改会合并，因为社区中的其他人在审阅你的更改时投入了时间和精力。只有每个人都参与审阅过程，这才行得通。

提交了更改后，不要期望其他人觉得有动机或有义务审核你的更改。在许多项目中，审阅是非常重要的，因此，如果你回复和审阅其他人的更改，你您将有更好的机会让自己的更改被审阅和批准。

3.不要留空评论

当你查看某人的代码时，仅添加+1不会产生什么用途。请至少表明你对更改做了什么。同样有用的是说你没有做什么。

例如，你可以说明仅查看代码，但实际上没有对其进行测试。或者你可以进一步下载和测试补丁集，并在评论中指出你测试了更改，并发现它如何工作。有时候，例如当我第一次查看更改时，我将指出我已经审阅了更改，但不是测试。

如果你不明白更改做了什么，随时提出问题。此外，如果你认为由于某些原因，建议的实施不是最佳实施，请随时给出替代实施。

如果你觉得没有准备好合并，不要害怕用-1标记更改。

只是为了+1是一个无益的行为。如果你坚持这样做，社区中的其他人将倾向于轻视你的评论。

4.不要玩Stackalytics系统

到目前为止，我所看到的最严重的违规是人们公然试图游戏Stackalytics系统。 Stackalytics是一个跟踪个人和公司参与OpenStack的工具。

例如，这是当前版本中Trove项目的Stackalytics页面：

评论：http://stackalytics.com/?module=trove-group

提交：http://stackalytics.com/?module=trove-group&metric=commits

它允许你以图形方式查看许多指标，并允许你以一些有趣的方式切割数据。

充满热情的新贡献者，容易陷入试图游戏系统的陷阱，并搁置评论或提交。如果你沿着这条路线走，结果可能会非常糟糕。例如，最近一个非常热心的人提出了一个更改，涉及大约150个项目，并试图添加一个CONTRIBUTING.rst文件到所有这些项目。接下来发生的事情记录在这个邮件列表线程中：

一些更改在它们被恢复之前被合并，绝大多数被放弃。

这样的更改没有真正有用的目的。它们还在CI系统中消耗过多的资源。我计算，这样大约产生1050 个CI工作，在CI系统上消耗大约190小时的时间。

我承认数字很重要，它们是表征参与的良好指标。但质量是一个更重要的指标，因为质量是贡献的指标。我坚信参与是关于展示，贡献是关于你在这里做了什么，并且贡献是比参与更重要的目标。

5.不要忽略评论

当你提交更改，并且人们审阅并提供评论时，请不要忽略。如果你认真对待一个更改，你会一直关注，直到它被合并。及时回复评论，就算只是说你会在一段时间后带来一个新的补丁集。

如果不这样做，请记住审阅是一个稀缺的资源，并且将来你的更改可能无法得到审阅者的关注。审阅你更改的其他人牺牲了别的时间来参加社区活动。至少，你应该承认并尊重他们的投入，并及时做出回应。

6.不要害羞

最重要的是，如果你不知道如何继续，不要害羞。如果你不确定如何处理某些事情，请在邮件列表上发布问题。如果这太公开了（其实这是完全正确的），在IRC问问题。如果这还太公开了，找到一个活跃在项目上的人（从PTL开始），并向该人发送电子邮件。

PTL作用的一个重要方面是提出这些问题，我们所有人（PTL）每月接收这些问题中的几个。不知道该问谁时，就在IRC #openstack或＃openstack-dev上抛出问题，你应该很快就收到回答。

，

7.不要成为IRC幽灵

要记住，IRC是一个异步介质。所以，不要期望实时的回答。OpenStack社区是高度分布式的，在美国时间的周一到周五的白天最活跃。如果你弹出IRC，问一个问题，然后消失，你可能不会得到你的答案。如果你不能呆在IRC上很长时间，请将问题发送到邮件列表。

但更好的是，你有很多方法可以连接到IRC和离开连接（所以你可以阅读scrollback），或找到一些其他机制来审查scrollback（如eavesdrop.openstack.org），看看你的问题是否有人回答。

作者：Amrith Kuma

来源：https://hypecycles.com/2017/01/0 ... nstack-contributor/

欢迎光临云萌主云应用官方论坛 (https://yunmengzhu.com/)