diff --git a/trusted-committer/zh/01-introduction-zh.asciidoc b/trusted-committer/zh/01-introduction-zh.asciidoc index 2d6031af..8b4475ba 100644 --- a/trusted-committer/zh/01-introduction-zh.asciidoc +++ b/trusted-committer/zh/01-introduction-zh.asciidoc @@ -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社区做出了贡献。这些贡献可能是代码或非代码工件，例如错误报告，功能请求或文档。 @@ -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的途径. diff --git a/trusted-committer/zh/02-ensuring-product-quality-zh.asciidoc b/trusted-committer/zh/02-ensuring-product-quality-zh.asciidoc index d74f8b90..984ac29a 100644 --- a/trusted-committer/zh/02-ensuring-product-quality-zh.asciidoc +++ b/trusted-committer/zh/02-ensuring-product-quality-zh.asciidoc @@ -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）_]达到质量标准。并且还需要负责维护软件的长期健康。 diff --git a/trusted-committer/zh/03-keeping-the-community-healthy-zh.asciidoc b/trusted-committer/zh/03-keeping-the-community-healthy-zh.asciidoc index 6389f745..27a5ce70 100644 --- a/trusted-committer/zh/03-keeping-the-community-healthy-zh.asciidoc +++ b/trusted-committer/zh/03-keeping-the-community-healthy-zh.asciidoc @@ -2,7 +2,7 @@ 导言指出，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的工作。人们通常认识不到这一点的重要性，但在营销社区及其产品的过程中，这确实是必不可少的。 @@ -10,7 +10,7 @@ 如果人们还倾向于留在社区里，证明他们知道在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的工作是通过交流和制定有用的贡献准则来确保贡献者真正专注于其项目。 diff --git a/trusted-committer/zh/04-uplevelling-community-members-zh.asciidoc b/trusted-committer/zh/04-uplevelling-community-members-zh.asciidoc index bcba395b..14d93506 100644 --- a/trusted-committer/zh/04-uplevelling-community-members-zh.asciidoc +++ b/trusted-committer/zh/04-uplevelling-community-members-zh.asciidoc @@ -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说，指导和推动人们去提升自己的能力，比花时间在编写软件上更重要。 diff --git a/trusted-committer/zh/05-lowering-the-barriers-to-entry-zh.asciidoc b/trusted-committer/zh/05-lowering-the-barriers-to-entry-zh.asciidoc index 05469ef0..4e1b73da 100644 --- a/trusted-committer/zh/05-lowering-the-barriers-to-entry-zh.asciidoc +++ b/trusted-committer/zh/05-lowering-the-barriers-to-entry-zh.asciidoc @@ -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）_]的期望。它应回答常见问题，例如： ** 如何提交错误报告或功能请求？ @@ -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应确保加入社区和参与贡献对他人来说是良好的经历。 diff --git a/trusted-committer/zh/06-advocating-for-the-communitys-needs-zh.asciidoc b/trusted-committer/zh/06-advocating-for-the-communitys-needs-zh.asciidoc index 5c40d674..3d6fd228 100644 --- a/trusted-committer/zh/06-advocating-for-the-communitys-needs-zh.asciidoc +++ b/trusted-committer/zh/06-advocating-for-the-communitys-needs-zh.asciidoc @@ -1,11 +1,11 @@ == 倡导社区需求 -InnerSource社区存在于协作的环境中，因此比开放源社区更受限制。有时，人们业务部门的利益与社区的利益并不一致。Trusted Committer对项目应有长远的安排和打算，他们了解健康的社区是健康代码的前提。这就是为什么许多InnerSource计划都以Apache Way的座右铭 http://theapacheway.com/community-over-code/[_Community over code._] 为指引的原因。另一方面，业务部门也会自然地关注InnerSource社区生产的产品。他们希望看到在短期或中期内，这能帮助企业提高利润。 +InnerSource社区存在于公司内部协作的环境中，因此比开放源社区更受限制。有时，人们业务部门的利益与社区的利益并不一致。Trusted Committer对项目应有长远的安排和打算，他们了解健康的社区是健康代码的前提。这就是为什么许多InnerSource初始团队都以Apache Way的座右铭 http://theapacheway.com/community-over-code/[_Community over code._] 为指引的原因。另一方面，业务部门也会自然地关注InnerSource社区生产的产品。他们希望看到在短期或中期内，这能帮助企业提高利润。 -在此潜在的冲突中，Trusted Committer将发挥至关重要的作用。Trusted Committer与组织建立了信任，并在此信任的基础上，倡导维护社区利益和保持公司软件的长期健康。他们负责传达技术风险以及与社区有关的管理风险。同时，Trusted Committer需要具有战略性，并在其公司的容忍度、自由度内工作。 +在此潜在的冲突中，Trusted Committer将发挥至关重要的作用。Trusted Committer与组织建立了信任，并在此信任的基础上，倡导维护社区利益和保持公司软件的长期健康。他们负责传达技术风险以及与社区有关的管理风险。同时，Trusted Committer需要具有战略视角，并在其公司的容忍度、自由度内工作。 -Trusted Committer还需要确保社区和个人贡献者的工作获得公众认可。公共信誉是用来支付捐赠者，特别是自愿捐赠者的货币。好的办法是公开表彰有价值的贡献者，并确保他的领导了解他们的贡献。忽视给予信誉可能会使个人贡献者感到沮丧，并损害社区的健康。这可能发生在尚未习惯InnerSource工作模式的公司中，或者当InnerSource社区开发的软件在后台运行，但管理人员根本不了解社区的贡献时。一个好的Trusted Committer将与管理层合作并倡导为公共信誉做贡献。不是出于恶意的抹杀贡献是很容易解决的。 +Trusted Committer还需要确保社区和个人贡献者的工作获得公众认可。公共信誉是用来支付贡献者，特别是自愿贡献者的货币。好的办法是公开表彰有价值的贡献者，并确保他的领导了解他们的贡献。忽视给予信誉可能会使个人贡献者感到沮丧，并损害社区的健康。这可能发生在尚未习惯InnerSource工作模式的公司中，或者当InnerSource社区开发的软件在后台运行，但管理人员根本不了解社区的贡献时。一个好的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去重视的常见情况是，没有给 https://innersourcecommons.org/resources/learningpath/contributor/zh/index[_贡献者（Contributor）_]足够的时间或权限。当社区正在贡献者部门以外的产品上工作，因此与他们的工作目标无关时，就会发生这种情况。在这种情况下，Trusted Committer应与 https://innersourcecommons.org/resources/learningpath/contributor/zh/index[_贡献者（Contributor）_]的工作领导进行沟通，并寻找相应的替代方案。 -总之，在许多情况下，Trusted Committer需要平衡个人贡献者和整个社区的利益。Trusted Committer应该清楚认识到，社区可以为组织提供的价值取决于社区的健康和寿命，并最终取决于两者之间的相互信赖关系。 +总之，在许多情况下，Trusted Committer需要平衡个人贡献者和整个社区的利益。Trusted Committer应该清楚认识到，社区可以为组织提供的价值取决于社区的健康和长期发展以及社区与组织之间的相互信赖关系。 diff --git a/trusted-committer/zh/07-becoming-a-trusted-committer-zh.asciidoc b/trusted-committer/zh/07-becoming-a-trusted-committer-zh.asciidoc index db48caf3..2ee4eff3 100644 --- a/trusted-committer/zh/07-becoming-a-trusted-committer-zh.asciidoc +++ b/trusted-committer/zh/07-becoming-a-trusted-committer-zh.asciidoc @@ -1,8 +1,8 @@ -== 如何成为受信任贡献者 +== 如何成为Trusted Committer 社区对于Trusted Committer的要求是非常高的，但作为一个Trusted Committer，会让人非常有成就感。如果你想通过成为一个Trusted Committer得到成长，您可能会问：我要怎样成为一个Trusted Committer，我会是合适的人选吗？ -Inner Source社区遵循一些与开源社区相同的原则，其中之一就是精英制度。在精英制度中，权力取决于个人的才能、努力和成就。换句话说，就等同于是Trusted Committer角色附带的责任和特权是需要通过做贡献赢得的。透明度是另一个开源价值，它也发挥了至关重要的作用，因为它使人才的努力和成就对整个社区可见。 +InnerSource 社区遵循一些与开源社区相同的原则，其中之一就是精英制度。在精英制度中，权力取决于个人的才能、努力和成就。换句话说，就等同于是Trusted Committer角色附带的责任和特权是需要通过做贡献赢得的。透明度是另一个开源价值，它也发挥了至关重要的作用，因为它使人才的努力和成就对整个社区可见。 正式成为Trusted Committer的过程每个社区都会有不同，主要取决于你在InnerSource中所处的社区，并且规则可能在不断变化。在基层社区中，创始人通常也自动承担Trusted Committer的角色。随着社区的发展，社区或现有的Trusted Committer可能会提名，并以投票的方式发展一名 https://innersourcecommons.org/resources/learningpath/contributor/zh/index[_贡献者（Contributor）_]成为Trusted Committer。理想情况下，被提名的贡献者需要自愿担任Trusted Committer角色，因为它需要大量的时间和奉献精神才能成功。