企业官网建设流程全解析

• 文档
• 教程
• 知识库

本篇指南以 Codehaus 社区及其《Codehaus 宣言》为核心，梳理一个曾在 Java 生态中孕育出 Groovy、Jetty、Gradle、Jackson、Drools 等数百个知名开源项目的协作社区，其多年沉淀下来的十条项目治理与社区运营准则。读完本文，你将掌握一套可落地的开源项目治理方法论：从提交者准入、小步快跑发布，到邮件沟通礼仪与争议决策机制，并对照原文逐条辨析译文措辞，理解其背后的工程管理哲学。

注：本文基于本仓库 codehaus-manifesto/README.md 的译文与原文对照版本整理，原文为 Codehaus 官网 manifesto 存档（2015-02-17），译文完成于 2018-10-21。Codehaus 大约于 2015 年 4 月下线，本文所引内容均为其下线前的存档资料。

一、Codehaus 是什么：一个孕育了数百个开源项目的社区

先简单介绍一下 Codehaus：它是一个协作构建开源项目的社区，强烈强调现代语言，并开发聚焦于满足实际需求的高质量组件。Groovy、Jetty、Gradle、XStream、Jackson、Drools、jMock、EasyMock、Grails、XDoclet、QDox、Esper、Mule、Janino、JBehave、Stomp以及其他数以百计的开源项目，都得感谢 Codehaus 社区。

很多项目听起来都是如雷贯耳吧，而这份精小的 Codehaus 宣言是 Codehaus 多年在技术管理与开源项目运营上的思考、总结与领悟，相信非常值得一读。

向 Codehaus 致敬！！

从这份宣言能学到什么

• 项目治理：贡献者话语权与团队决策机制的平衡之道；
• 社区运营：新人引入、项目准入、沟通礼仪的实操规范；
• 工程实践：质量与频繁小发布的节奏把控，以及"用代码说话"的协作文化。

二、Codehaus 宣言（译文全文）

1. Codehaus观察到，基于指标、活跃时间和指派任务的分析，贡献更多的提交者在项目上有更大的话语权。
2. Codehaus是鼓励人们持续做出代码的地方，而不是用官僚流程把人们的项目框在一起的地方。
3. Codehaus鼓励项目追求质量和频繁的小发布。
4. Codehaus鼓励提交者成为敬人有礼的朋友，尽可能地与大家碰面交流。面对面优于邮件。
5. Codehaus支持多样性（在合适时），而不是强制一统与同质。
6. Codehaus在吸纳提交者上设定高标准，引荐是常见的做法。新进的提交者期望要展示出代码水准以及优秀的品格。其成熟与才智应已有展现（如果年轻则应该在他早年就展现出来了）。
7. 对于已有项目，新进的提交者期望在开始时先慢慢贡献一些小的不紧急的提交，之后再承担更大的自主的提交。
8. Codehaus在准入项目上设定高标准。项目应该是已经发布的或是接近发布的。
9. Codehaus鼓励人们在邮件沟通上要简明扼要，并注重互联网的礼仪。用十篇长文来证明一个问题是个拙劣的方式；更好的方式是一个（失败的）单元测试。
10. 当争论不定时，专制是正解。

三、原文与逐条点评：翻译对照与技术解析

点评来自 @_ShawnQianx_ 2018 年 9 月的技术分享。Qian Sir 之点评一字未动，貌似随性又犀利劲到的点评让内容更多了一分神采飞扬。因为这份点评火力十足，个人觉得对原文原义的口感影响不少，所以没有直接放到译文中，以免你先入为主、断章取义影响对原文原义的品味。

第 1 条：贡献者话语权来自实质贡献

The Codehaus recognizes that some committers, based upon metrics, longevity and appointed management, have greater say on a project than others. （谁贡献的多，谁说了算）

技术解析：这一条提出了开源项目中最朴素也最有效的治理原则——话语权应与贡献挂钩。关键词包括：

• metrics（指标）：提交量、代码评审参与度、issue 响应次数等可量化数据；
• longevity（活跃时间）：长期、稳定的贡献记录比短期爆发更有说服力；
• appointed management（指派任务）：被授予的维护职责与官方角色。

实践中这意味着：项目维护者不必依赖职级或资历，而是通过客观的贡献记录自然形成影响力层级。这与"代码甚于流程"（第 2 条）互为表里——话语权是干出来的，不是任命的。

第 2 条：代码甚于流程

The Codehaus is a place where people are encouraged to get on with code rather than tie their projects up with bureaucracy. （代码甚于流程）

技术解析：Codehaus 明确反对"官僚流程框住项目"。其含义并非否定流程，而是强调流程应当服务于产出：

• 提交、评审、发布流程应轻量，能快速让代码落地；
• 过度流程化（冗长的 RFC、多层审批、繁重的模板）会扼杀贡献热情；
• 对小型开源项目而言，最快的验证方式是提交代码，而不是提交文档。

这条原则在今天仍然有效：许多高效开源项目采用"小 PR + 快速合入 + 持续发布"的模式，正是这一理念的延续。

第 3 条：质量与频繁小发布

The Codehaus encourages projects to strive for quality and for frequent small releases. （讲求质量，小步快跑）

技术解析：这一条同时提出两个看似矛盾的诉求，恰恰是开源发布节奏的精髓：

• quality（质量）：每一次发布都应经得起使用者的检验；
• frequent small releases（频繁的小发布）：小步快跑让每次变更范围可控、回归成本低、反馈周期短。

小发布之所以优于大版本，是因为它降低了单次变更的风险面：用户更容易定位回归问题，维护者更容易控制发布窗口。这一节奏策略与现代持续交付（Continuous Delivery）理念完全一致。

第 4 条：面对面优于邮件

The Codehaus encourages committers to be respectful friends, meet up with each other as often as possible. Face-to-face is superior to email. （交流靠吼，优于电邮）

技术解析：这里的"交流靠吼"是点评者的戏谑说法，原意是面对面的即时沟通优于异步邮件：

• 邮件适合留痕、跨时区与长文讨论；
• 但高带宽、低延迟的面对面交流（会议、线下聚会、视频会议）能显著消解误解、加速决策、建立信任；
• "敬人有礼的朋友"（respectful friends）意味着社区成员之间应是相互尊重的伙伴关系，而非纯粹的雇佣或上下级关系。

在今天，这条准则对应着开源社区中的"会议优先于拉锯式评论"——把复杂争议拿到实时对话中解决。

第 5 条：多样性优于强制同质

The Codehaus stands in favour of diversity (where appropriate) over enforced convergence and homogeneity. （要百花齐放，不要千篇一律）

技术解析：注意原文的限定语"where appropriate"（在合适时）——多样性不是无条件的口号：

• 在技术选型、实现风格、社区文化层面，允许多元并存可以激发创新；
• 但在接口契约、兼容性、核心架构等必须统一的层面，仍应保持收敛；
• 强制一统（enforced convergence）与同质化（homogeneity）会压制社区的活力。

这是开源社区治理中"自由与秩序"的平衡：在适当的地方放开，在必要的地方收敛。

第 6 条：提交者准入的高标准与引荐制

The Codehaus places a high bar on entry for committers. Referral is a common means. A new committer is expected to show strong character elements as well as a talent for code. Maturity and wisdom (possibly in advance of years if a youngster) should be demonstrated. （严选成员，推荐制，有实力的入）

技术解析：Codehaus 对提交者（committer）设置了很高的准入门槛，这一条包含三层要求：

1. 引荐制（Referral is a common means）：新人通常由现有成员背书引入，社区信任通过人际网络传递；
2. 代码水准 + 优秀品格（a talent for code + strong character elements）：技术能力是门槛，但品格（协作态度、诚信、尊重他人）同样关键；
3. 成熟与才智（Maturity and wisdom）：即使是年轻开发者，也应在早期经历中展现出成熟与判断力（possibly in advance of years if a youngster）。

这套高标准准入机制保证了社区的整体质量密度，也解释了为什么 Codehaus 能孵化出如此多高质量的组件项目。

第 7 条：新提交者从小提交开始

New committers to an existing project are expected to ease themselves in with small and deferrent commits to start, and greater free-will may be assumed later. （项目中的新客，从提交 bug fix 开始，别一上来就重构优化）

技术解析：这一条是给新人的成长路径指南：

• small and deferrent commits（小而不急的提交）：初期的提交应范围小、低风险，如 bug 修复、文档修正、测试补充；
• ease themselves in（慢慢进入）：先用小提交熟悉项目规范、构建流程与评审文化；
• greater free-will may be assumed later（之后可承担更大自主的提交）：随着信任建立，逐步获得重构、新特性等更大范围的自主权。

这套路径与第 6 条的高标准准入互为补充：准入严、起步稳、授权渐进，既保护项目稳定，也保护新人成长曲线。

第 8 条：项目准入的高标准

The Codehaus places a high bar on entry for projects. They should be released or near it. （严选项目，成熟的入 v0.1 的滚）

技术解析：Codehaus 不只严选提交者，也严选入驻的项目：

• released or near it（已经发布或接近发布）：入驻项目应当已有可用的发布版本，或处于发布前夜；
• 拒绝半成品、愿景式的空壳项目占用社区资源；
• 点评中的"v0.1 的滚"是戏谑，指那些只停留在 0.1 版本、尚未成熟的项目不适合入驻。

这一准入标准与第 6 条构成了 Codehaus 的"双重过滤"：对人不将就，对项目也不将就，从而保证了社区内项目的整体质量。

第 9 条：简明沟通，用代码证明问题

The Codehaus encourages people to be brief in email and to honor internet etiquette. Ten furlongs of text justifying a position is poor form; better would be a (failing) unit test. （高效沟通，能用代码绝不文字）

技术解析：这一条把"简洁"提升到了工程方法论的高度：

• brief in email + internet etiquette（邮件简明 + 互联网礼仪）：尊重他人的阅读时间，控制篇幅；
• Ten furlongs of text（冗长文字）：furlong 是长度单位（约 201 米），此处夸张比喻超长邮件；
• a (failing) unit test（一个失败的单元测试）：比长篇论证问题更好的方式，是提交一个能复现问题的失败测试——这既是精准的问题陈述，也是修复的起点。

这条原则在今天的开源协作中已成为标准实践：报告 bug 时附带最小复现用例（minimal reproduction），远胜过千字描述。失败的单测不仅是沟通工具，更是 TDD 流程的第一步。

第 10 条：争论不定时，专制是正解

In case of disagreement, The Despots are right. （必要独裁）

技术解析：这是宣言中最具争议也最精辟的一条：

• The Despots（独裁者）：指被授予最终决策权的项目维护者（BDFL，仁慈的终身独裁者式角色）；
• 当社区争论僵持不下、无法达成共识时，必须有人拍板，避免无限拉锯消耗项目活力；
• 这种"专制"是有前提的：它建立在第 1 条（贡献者话语权）、第 6 条（高标准准入）的基础之上——只有真正有贡献、有判断力的维护者才配拥有最终拍板权。

这与第 5 条（多样性）并不矛盾：多样性的讨论空间与关键时刻的决策权威，共同构成了开源治理的完整闭环。

四、十条宣言的治理模型总结

将十条宣言按主题归类，可以提炼出一套完整的开源项目治理模型：

这套模型的底层逻辑是一致的：用贡献与质量说话，用流程服务于人而非束缚人，用有限的关键决策权化解无限争论。

五、结语：Codehaus 遗产的当代意义

Codehaus 大约于 2015 年 4 月下线，但其孕育的组件（Groovy、Jetty、Gradle、Jackson、Drools 等）至今仍是 Java 生态的中流砥柱。这份宣言虽然篇幅精小，却浓缩了一个成功开源社区十余年的运营智慧：

• 对项目维护者：它是一份团队治理与节奏管理的参考清单；
• 对新加入者：它是一份"如何被信任、如何成长"的路线图；
• 对社区运营者：它是一套可迁移的准入、沟通与决策机制模板。

对照 本仓库的译文与原文对照版本，逐条品读译文措辞与点评者的犀利短评，可以更完整地还原这份宣言的原义与神采。

向 Codehaus 致敬！！

• 文档
• 教程
• 知识库