指导思想
埏埴以為器,當其無,有器之用。
—— 老子
激进的简单性
- 可扩展性和协同工作能力比各种不重要的功能更重要。
- 简单、快速和容易铸就了规模。
- 协同工作能力来自于不加修饰的、易消化的内容。
- 更少的干扰会带来更好的写作和更有效的阅读。
源文本的高可读性
- 纯文本不仅够用,而且更有优势。 Markdown 本身并不是这个公式的必要条件,但它是目前最好和最广泛支持的解决方案。一般不鼓励使用HTML。
- 内容和呈现不应该混在一起。 应该保证总能抛弃渲染出的网页,而在源文本中阅读到基本信息。如果不愿意,用户永远都不用管内容是如何呈现的。
- 可移植性和面向未来为未来的整合形式留出了想象空间,并且通过尽可能地保持源头的可读性来实现。
- 静态内容比动态内容好,因为内容不应该依赖于服务器。然而,新鲜的比陈旧的要好。我们努力平衡这些需求。
最小可行的文档
- 及时地以文档的形式记录:这是一项必要的苦差事,人们要学会品味,因为它随着时间的推移而得到回报。参见「最佳实践」。
- 简洁而实用的文档比冗长而详尽的文件要好。 绝大多数用户只需要作者全部知识中的一小部分,但他们可能需要快速和频繁地查阅。
「更好」比「完美」更好
- 增量性的改进比长期的争论要好。 耐心和对不完美的容忍使项目得以有机地发展。
- 不要舔饼干,把盘子递过来。 (译者注:把饼干舔了而不吃,让别人也吃不了;意为「别占着茅坑不拉屎,拉不出就先让别人来拉」)在潜在的有影响的项目中,只选择那些你真正能处理的项目,并放手那些你没能力处理的项目。