Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions trusted-committer/zh/01-introduction-zh.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@

Trusted Committer角色是InnerSource社区中的关键角色之一。将Trusted Committer视为你所在的社区中所信任的对象,他们可以通过重要的技术决策和指导贡献者来最终获得收益。我们对Trusted Committer的要求很高,同时这个岗位也会得到很高的回报。这个角色并不是一个自以为是的把关者,甚至他对任何InnerSource社区的成功都至关重要。

一般而言,Trusted Committer角色是由其职责而不是其特权定义的。在很高程度上,可信任提交者代表其InnerSource社区和该社区正在开发的产品的利益。他们关心社区和产品的健康。因此,作为Trusted Committer,您将同时承担面向技术和社区的责任。我们将在以下各章节中探讨这两个方面。
一般而言,Trusted Committer角色是由其职责而不是其特权定义的。在很高程度上 Trusted Committer 代表其InnerSource社区和该社区正在开发的产品的利益。他们关心社区和产品的健康。因此,作为Trusted Committer,您将同时承担面向技术和社区的责任。我们将在以下各章节中探讨这两个方面。

在详细介绍Trusted Committer实际功能之前,让我们花一些时间从高度抽象的角度将Trusted Committer角色与InnerSource中的其他角色进行对比,并解释为什么我们认为该名称既恰当又重要。让我们从 https://innersourcecommons.org/resources/learningpath/contributor/zh/index[_贡献者(Contributor)_]角色开始。顾名思义, https://innersourcecommons.org/resources/learningpath/contributor/zh/index[_贡献者(Contributor)_]为InnerSource社区做出了贡献。这些贡献可能是代码或非代码工件,例如错误报告,功能请求或文档。

Expand Down Expand Up @@ -32,7 +32,7 @@ Trusted Committer负有各种责任,包括:

3. https://innersourcecommons.org/resources/learningpath/trusted-committer/zh/05/[_减少贡献的障碍(Reducing the barriers to making contributions)_]

4. https://innersourcecommons.org/resources/learningpath/trusted-committer/zh/04/[_提升社区(Upleveling the community)_]
4. https://innersourcecommons.org/resources/learningpath/trusted-committer/zh/04/[_牵引社区(Upleveling the community)_]

5. https://innersourcecommons.org/resources/learningpath/trusted-committer/zh/06/[_倡导社区的需求 (Advocating the community’s needs)_]
我们将在接下来的章节中更深入地探讨这些职责,并在本文结尾处探索成为Trusted Committer的途径.
10 changes: 5 additions & 5 deletions trusted-committer/zh/02-ensuring-product-quality-zh.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -8,12 +8,12 @@ Trusted Committer的工作是在其社区中交流和阐明质量标准,并以

Trusted Committer还需要确保社区拥有生产高质量软件所需的基础结构和工具。同行评审通常会作为拉取请求(PRs)的一部分,通常用于确保质量。尽管每个人都可以通过提出重要的进展来启动和参与项目,但是通常只有Trusted Committer才能最终接受、合并或拒绝贡献。这就是我们早先所说的“Trusted Committer可以将代码推向生产环境”的意思。Trusted Committer还应该在PR期间确认贡献者不要超过截止日期进行贡献。

也就是说,实现这一目标最终是 https://innersourcecommons.org/resources/learningpath/contributor/zh/index[_贡献者(Contributor)_]的工作。Trusted Committer的工作不是默认接受所有贡献,而仅接受在质量和范围方面符合定义标准的贡献。Trusted Committer应避免重写贡献者的代码去让它们尽可能符合规定,即使这意味着要花费更多时间在PR中为 https://innersourcecommons.org/resources/learningpath/contributor/zh/index[_贡献者(Contributor)_]提供支持。Trusted Committer应具有长远的眼光,并了解这种支持是对社区寿命的一种投资,从长远来看,它将提高社区的发展速度。
也就是说,实现这一目标最终是 https://innersourcecommons.org/resources/learningpath/contributor/zh/index[_贡献者(Contributor)_]的工作。Trusted Committer的工作不是默认接受所有贡献,而仅接受在质量和范围方面符合定义标准的贡献。Trusted Committer应避免重写贡献者的代码去让它们尽可能符合规定,即使这意味着要花费更多时间在PR中为 https://innersourcecommons.org/resources/learningpath/contributor/zh/index[_贡献者(Contributor)_]提供支持。Trusted Committer应具有长远的眼光,并了解这种支持是对社区的一种长期投资,从长远来看,它将提高社区的发展速度。

有时项目要求或限制不是都能预判的,而是在开发过程中被发现的。Trusted Committer还会负责为 https://innersourcecommons.org/resources/learningpath/product-owner/index[_产品所有者(Product Owner)_]和贡献者(Contributor)捕获并记录这些发现。
有时项目需求或限制不是都能预先设计的,而是在开发过程中被发现的。Trusted Committer还会负责为 https://innersourcecommons.org/resources/learningpath/product-owner/index[_产品所有者(Product Owner)_]和贡献者(Contributor)捕获并记录这些发现。

但是,Trusted Committer在控制质量方面的权限超出了普通PR的范围。Trusted Committer从战略角度考虑质量,并确保所构建软件的寿命。从确保代码的整洁到维护整个软件的概念完整性,这涉及到面向整体代码的责任。还需要进行面向管理的任务,例如确保给社区足够的时间来重构其软件,或者在需要时为支持质量改进而推迟发布日期。Trusted Committer的工作效率与代码运行状况密切相关
但是,Trusted Committer在控制质量方面的权限超出了普通PR的范围。Trusted Committer从战略角度考虑质量,并确保所构建软件的长期生命力。从确保代码的整洁到维护整个软件的概念完整性,这涉及到面向整体代码的责任。还需要完成面向管理的任务,例如确保给社区足够的时间来重构其软件,或者在需要时为支持质量改进而推迟发布日期。Trusted Committer的工作效率与代码健康状况密切相关

如果没有后者,则Trusted Committer将不得不花费大量宝贵的时间记录错误或脆弱的体系结构和验证解决办法,并且将会没有足够的时间花在发展和指导 https://innersourcecommons.org/resources/learningpath/contributor/zh/index[_贡献者(Contributor)_]上。
如果没有后者,则Trusted Committer将不得不花费大量宝贵的时间记录错误或在脆弱的体系结构和验证解决办法,并且将会没有足够的时间花在发展和指导 https://innersourcecommons.org/resources/learningpath/contributor/zh/index[_贡献者(Contributor)_]上。

总而言之,确保产品质量是Trusted Committer的关键责任。他们设定质量标准并以身作则。他们参与PR并帮助 https://innersourcecommons.org/resources/learningpath/contributor/zh/index[_贡献者(Contributor)_]达到质量标准。并且还需要负责软件的长期运行状况
总而言之,确保产品质量是Trusted Committer的关键责任。他们设定质量标准并以身作则。他们参与PR并帮助 https://innersourcecommons.org/resources/learningpath/contributor/zh/index[_贡献者(Contributor)_]达到质量标准。并且还需要负责维护软件的长期健康
Original file line number Diff line number Diff line change
Expand Up @@ -2,15 +2,15 @@

导言指出,Trusted Committer既要承担技术责任,又要承担社区责任。仅关注代码和代码健康是不够的。为了实现长期的目标,Trusted Committers应该努力保持软件构建社区的健康。因此,他们必须在确保产品质量和保持健康社区之间取得平衡。

健康的社区是什么样的?很简单,在一个健康的社区中, https://innersourcecommons.org/resources/learningpath/contributor/index[_贡献者(Contributor)_]往往会持续进行贡献,将大部分时间花费在开发软件上,并从中提升自己的能力。这样的话,一个健康的社区将能不断发展。
健康的社区是什么样的?很简单,在一个健康的社区中, https://innersourcecommons.org/resources/learningpath/contributor/zh/index[_贡献者(Contributor)_]往往会持续进行贡献,将大部分时间花费在开发软件上,并从中提升自己的能力。这样的话,一个健康的社区将能不断发展。

为什么 https://innersourcecommons.org/resources/learningpath/contributor/zh/index[_贡献者(Contributor)_]会加入并停留在社区中?有些人这样做是因为他们认同社区的宗旨或使命。清楚地表达和贯彻社区的宗旨是Trusted Committer的工作。人们通常认识不到这一点的重要性,但在营销社区及其产品的过程中,这确实是必不可少的。

人们留下来的另一个更关键的原因是,他们喜欢与社区中的其他成员(包括Trusted Committer)一起工作。在一个繁荣的社区里成员间通常会相互尊重和相互沟通。贡献被视为馈赠或付出,而不是娱乐,而出色的(尤其是NO.1) https://innersourcecommons.org/resources/learningpath/contributor/zh/index[_贡献者(Contributor)_]通常会受到称赞。Trusted Committer在所有这方面的工作主要是为他人树立榜样,就是为预期的软件质量水平树立榜样。如有必要,Trusted Committer 可以为社区制定并制定行为准则。如果有某些社区成员的行为对社区健康有所损害,那么Trusted Committer有责任去解决此类问题。Trusted Committer应为人们创造机会,使他们能够定期(线上或线下)聚在一起,彼此了解并在有冲突时和平解决。

如果人们还倾向于留在社区里,证明他们知道在InnerSource社区工作是获得新技能和个人成长的绝好机会。这其实是Trusted Committer的角色真正重要的地方。Trusted Committer通常会成为初级开发人员的指导者,并且在PR期间去指出需要改进的地方,还详细说明了为什么需要改进以及如何进行改进。他们提供了更改背后的理论或经验,并为更改的最佳方法提供了建议。这样,Trusted Committer可以提高成员社区中的学习速度,远远超过他们在传统软件开发项目中的学习速度。

我们认为,Trusted Committer应在 https://innersourcecommons.org/resources/learningpath/contributor/zh/index[_贡献者(Contributor)_] PR期间就进行指导,而不要等到发布日期,除非确实没有这个精力。PR期间,良好指导可提高贡献者(contributor的信任度和参与度,因此吸引更多的贡献。我们将在“升级社区”中对此进行更多讨论。
我们认为,Trusted Committer应在 https://innersourcecommons.org/resources/learningpath/contributor/zh/index[_贡献者(Contributor)_] PR期间就进行指导,而不要等到发布日期,除非确实没有这个精力。PR期间,良好指导可提高 https://innersourcecommons.org/resources/learningpath/contributor/zh/index[_贡献者(Contributor)_]的信任度和参与度,因此吸引更多的贡献。我们将在“提升社区”中对此进行更多讨论。

最后,有些人会停留在InnerSource社区中,是因为他们开始专注于开发软件,而不是去做一些不实际、浪费性的工作,尤其是在大型公司中——他们太注重流程。在此背景下,Trusted Committer的工作是通过交流和制定有用的贡献准则来确保贡献者真正专注于其项目。

Expand Down
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
== 升级社区成员
== 牵引社区成员

在InnerSource社区中会存在有一个深入参与的过程。期间一定会有不了解这个社区的阶段。首先,新手可能对社区和社区内的产品感兴趣,但尚未使用过它。然后会有使用过产品但没有贡献过的用户。然后是至少做出过一次贡献的 https://innersourcecommons.org/resources/learningpath/contributor/zh/index[_贡献者(Contributor)_],最后是负责整体软件和社区的Trusted Committer。作为Trusted Committer,您有责任令社区成员沿着这一连续性前进,并提升他们的贡献能力。从这个意义上讲,Trusted Committer在其社区中充当力量倍增器。

对于Trusted Committer而言,营销其产品和社区以增加新用户和消费者数量非常重要。他们还应该通过与消费者保持交流去引导他们做出贡献,并尝试引起潜在 https://innersourcecommons.org/resources/learningpath/contributor/zh/index[_贡献者(Contributor)_]的利益,并使之与社区的利益保持一致。通常,有效的办法是,让 https://innersourcecommons.org/resources/learningpath/contributor/zh/index[_贡献者(Contributor)_]参与贡献的是有益于其部门或公司角色的工作。开发工具和自动化就是很好的例子。
对于Trusted Committer而言,产品营销和社区增加新用户和消费者数量非常重要。他们还应该通过与消费者保持交流去引导他们做出贡献,并尝试牵引潜在 https://innersourcecommons.org/resources/learningpath/contributor/zh/index[_贡献者(Contributor)_]的利益,并使之与社区的利益保持一致。通常,有效的办法是,让 https://innersourcecommons.org/resources/learningpath/contributor/zh/index[_贡献者(Contributor)_]参与贡献的是有益于其部门或公司角色的工作。开发工具和自动化就是很好的例子。

最后,Trusted Committer有责任在鼓励大家完成挑战性任务、指导他们完成工作的过程中,来识别和支持有成长潜力的贡献者。我们认为,这是Trusted Committer的最高责任,对于Trusted Committer和 https://innersourcecommons.org/resources/learningpath/contributor/zh/index[_贡献者(Contributor)_]来说都是非常有价值的。我们听过一些Trusted Committer说,指导和推动人们去提升自己的能力,比花时间在编写软件上更重要。

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@

这就是为什么对于Trusted Committer而言,使潜在 https://innersourcecommons.org/resources/learningpath/contributor/zh/index[_贡献者(Contributor)_]向贡献者成长的重要性。有很多事情可以帮助到您实现这个目的:

* 在每个代码存储库中都会有一个README.md。优秀的README.md解释了存储库中的内容及其用途。此外,它应提供有关如何获取,构建,测试和使用存储库中软件的详细说明,包括有关许可证的信息。
* 在每个代码存储库中都会有一个README.md。优秀的README.md解释了代码库中的内容及其用途。此外,它应提供有关如何获取,构建,测试和使用代码库中软件的详细说明,包括有关许可证的信息。
* 拥有一个良好的CONTRIBUTING.md,其中概述了 https://innersourcecommons.org/resources/learningpath/contributor/zh/index[_贡献者(Contributor)_]的期望。它应回答常见问题,例如:

** 如何提交错误报告或功能请求?
Expand All @@ -25,6 +25,6 @@

有两种常见的贡献模型:_共享代码库_ 以及 _fork和join_。两者都有优势,作为Trusted Committer,你应该希望社区同时支持这两种模型,以适应贡献者和潜在贡献者的不同需求。您的贡献者经常会遇到有关贡献过程或社区本身的问题,而必须有人来回答这些问题。因此,对于任何InnerSource社区来说,重要的是要有一个或多个联系人可以回答这些问题。通常,来自“Trusted Committer”组中的某个人是联系人,否则,他们需要确保有“随时待命”的社区成员。

帮助潜在的 https://innersourcecommons.org/resources/learningpath/contributor/zh/index[_贡献者(Contributor)_]确定需要哪些贡献也很重要。这些可以是代码贡献,也可以是非代码贡献,例如编写文档,创建插图或组织事件。一种常见的实现方法是在社区中设置“新手任务”,或为 https://innersourcecommons.org/resources/learningpath/contributor/zh/index[_贡献者(Contributor)_]提供一个任务市场让他们能够挑选任务。
帮助潜在的 https://innersourcecommons.org/resources/learningpath/contributor/zh/index[_贡献者(Contributor)_]确定需要哪些贡献也很重要。这些可以是代码贡献,也可以是非代码贡献,例如编写文档,创建插图或组织活动。一种常见的实现方法是在社区中设置“新手任务”,或为 https://innersourcecommons.org/resources/learningpath/contributor/zh/index[_贡献者(Contributor)_]提供一个任务市场让他们能够挑选任务。

总而言之,对于公司环境中的InnerSource社区而言,将贡献的障碍降低到最低水平,以允许更多人贡献是非常重要的。这意味着成员既可以访问有用的文档,也可以回答任何问题,以此鼓励协作。总之,Trusted Committer应确保加入社区和参与贡献对他人来说是良好的经历。
Loading