引言: 呈现开源之道#

英语中有句谚语说:“我的疯狂自有章法。[1]。” 大多数时候,我们做的事情在外界观察者眼中完全不合常理。脱离具体情境来看,这些行为简直荒谬至极。但对于身处这片混沌——这场活动旋风中心的人们而言,其中自有一种规律性、可预测性和特定动机。这就是道。

道即行事之法,是某种特定的实践方式或风格。开源社区管理的实践就像一种难以理解的疯狂形式,尤其对那些不熟悉开源软件开发流程的人,或是那些突然需要协调他人共同参与开发的人而言。本指南旨在揭示这种不断演进的方法论与实践形式,其核心只有一个简单问题:你倾向于以何种方式实践开源之道?

但更深层次而言,这项工作真正探讨的是:人们为何要以这种方式开展工作?为何要用这种或那种方法来组织这场"疯狂"?

因此从这个引言中,你应该把握两个要点:

  1. 要成功且可持续地创建和维护开源软件,必须明确"做什么"、"怎么做"以及"为什么做"这三个核心问题。

  2. 本指南汇集了大量开源实践者的观点,这些人经常需要回答"我们为何以这种方式开展开源工作"这类问题。

特别说明,本指南是一份动态文档,致力于汇集并传播多元声音——这些声音同样(且带有一定主观性地)在探索创建和管理开源软件社区的最佳方式。

这些声音共同构成了围绕开源软件社区管理的实践社群

事物的形状(即我们所做的假设)#

浏览本指南目录时,请注意其组织脉络:从用户到参与者再到贡献者。这种编排方式精准呈现了我们对社区形成与发展过程的理解。而这一切都始于某种需求。若你曾参与开源项目及社区工作,很可能多次见证这样的循环:

  1. 个人或团体为解决某个问题,开发出提供初步解决方案的软件雏形。

  2. 具有相似需求的人们开始使用该软件,逐渐形成核心用户群

  3. 从用户群中涌现出推广者(爱好者),他们积极推广该软件及其周边形成的社区(即该项目所倡导的价值观与原则)。

  4. 最终,从用户和爱好者中会涌现出这样一群人——他们有意愿(并逐渐具备能力)以某种方式为软件做出贡献;正是这些人确保项目保持活力,并能应对最初开发时所要解决问题的演变特性。

因此,项目持续关注的核心在于悉心维护用户群体,因为其中部分人将成为贡献者——而你需要他们出于热爱而非怨愤参与其中。

这一切的关键在于认可各种类型、各个层级的贡献价值。最佳实践不是只推崇单一类型的贡献,而是将项目获得的所有馈赠都视为同等珍贵。这些贡献包括内容与代码、时间与精力,以及通过活动、论坛讨论、基础设施维护等方式为项目做出的各类广泛贡献。

当你降低参与门槛时,你的项目就能在各个层面都显得友好包容。这并不意味着要移除所有障碍——只需合理降低大多数门槛即可。例如,对于需要获取系统权限的人员,适当的准入限制是必要的,这类门槛与那些仅允许特定参与者贡献帮助文档或配置管理系统补丁的限制有着本质区别。

我们的核心观点#

本指南贯穿着一个核心理念,它决定了内容的编排方式,也指引着路径上每个步骤的呈现——无论你处于开源实践的哪个阶段,都能找到自己的定位。

以用户为中心,全面降低参与门槛。

贡献者源于参与者,而所有参与者最初都是使用者。

以用户为中心推进项目,同时保持社区开放,欢迎那些对软件开发过程产生好奇的用户,从而让你的软件大获成功。

因此,本指南的路径是:

  1. 吸引用户使用你的软件,因为它能解决他们的问题;然后

  2. 引导参与者,尤其是那些关心开源和分享好的解决方案的参与者,使他们能够成为你软件的有效爱好者;

  3. 培养贡献者从这个丰富且充满活力的用户和爱好者群体中,确保这些人在了解软件开发过程时,能够看到自己的影子并构想自己如何融入。确保当他们加入贡献者队伍时,障碍明显降低且氛围友好。

可以这样理解:让人们知道你举办了一场精彩的舞会是一回事;而让这些舞者主动宣扬你举办舞会的方式又是另一回事。最了不起的是,能让这场舞会不断进化,欢迎来自世界各地的各种音乐与舞蹈形式。

让看到海报并前来参与的舞者们留下来是第一步,如果他们能立刻感受到这里也是属于他们的天地,那将大有裨益。

你可以看到,这条通往项目成功的道路并不一定强调专业技能(甚至与项目相关的现有技能),而是更看重好奇心、愿意尝试软件、关心软件并帮助创造软件的意愿。这并不意味着人们不会为项目带来技能;事实上他们会的,许多人从第一次接触项目时就带来了技能。但比起教会某人真正关心你的项目,传授技能要容易得多。

在这段旅程中,我们推荐了许多最佳实践,包括如何制定衡量社区进展的计划。我们还列出了一些需要特别注意的具体领域,其中包含针对社区管理者自身心理健康与自我关怀的深入讨论。

我们更深入地传达所有这些信息的最佳方式是通过故事。除了章节正文中自然出现的故事外,本指南和开源之道社区中的其他领域汇集了这些关于"为什么"的故事。

本指南的结构#

本指南的每个部分都包含一个或多个章节。

章节用于讨论一个独立主题或一组紧密相关的主题。

其理念在于,你可以独立阅读任意章节,无需通读整本指南即可理解该章节内容并付诸实践。

我们的愿景是每个章节将包含以下几个部分:

  • 引言

  • 主体内容,采用第三人称视角撰写,注重平衡"是什么"、"怎么做"和"为什么"的内容。这里讲述的案例(故事)简短且采用第三人称

  • 章节末尾的术语表,定义该章节中术语的特殊用法

  • 从业者分享实用且富有启发性的经验故事(可以第一人称撰写)

如果你发现某个章节缺少上述任一要素,欢迎为该项目贡献你的建议与见解!

一个不断自我重建的实践社群#

你在此读到的内容,只是这个社区不断收集、培育和维护的原则体系、实施方案及案例库中的一个侧面。

归根结底,这只是整理这些材料的一种方式(可以说是一种组织混乱的方法)。我们将持续更新本指南,发布类似的新指南,并尝试用其他方式来理解和呈现这些内容。

但核心在于——除了了解那些能惠及开源社区的"做什么"与"怎么做"——你还将领悟背后的"为什么",并能将这些深层理念传播到你所至之处。