philosophy style guide

《Philosophy Style Guide》核心内容总结如下： 1. **极致简洁（Radical simplicity）** - 可扩展性和互操作性比非必要功能更重要，简单性是实现规模、速度和易用性的基础。 - 减少干扰能提升写作和阅读效率，新功能应避免干扰最简单的用例，并对非目标用户保持不可见。 - 本指南面向普通工程师设计，目标是减少上下文切换，使用与代码读写工具一致的文档交互方式。 2. **可读的源文本（Readable source text）** - 纯文本是最佳选择，Markdown是目前最优解，避免使用HTML。 - 内容与呈现分离，确保源文本可独立阅读，用户无需接触呈现层即可获取关键信息。 - 保持源文本的可移植性和未来兼容性，优先使用静态内容，同时平衡内容的新鲜度。 3. **最小可行文档（Minimum viable documentation）** - 文档应简洁实用，避免过于冗长。用户通常只需快速获取小部分关键信息即可满足需求。 4. **增量改进（Better is better than perfect）** - 逐步优化优先于无休止的完善，容忍不完美以实现自然演进。 - 合理选择任务，专注于可完成的项目，避免过度承诺。 总结：本文档倡导通过简洁、可读和实用性的原则，提升文档和工具的效率与可维护性，强调用户体验和工程师的实际需求。