App项目开发准则

GitHub 著名的蒙娜丽莎猫旁边总会随机出现一句话，GitHub 特地提供了 API 供人去调用这些句子。

api.github.com/zen

api.github.com/octocat

API 返回的全部结果如下：

• Responsive is better than fast（有求必应比单纯快要好）
• It’s not fully shipped until it’s fast（只有响应速度够快了，才会完全出货的）
• Anything added dilutes everything else（任何添加的东西都会稀释其他的东西）
• Practicality beats purity（实用性优于纯洁性）
• Approachable is better than simple（易于理解比简单要好）
• Mind your words, they are important（注意你的使用词，它们很重要）
• Speak like a human（说人话）
• Half measures are as bad as nothing at all（半途而废是坏事）
• Encourage flow（鼓励工作流）
• Non-blocking is better than blocking（非阻塞优于阻塞）
• Favor focus over features（优先关注焦点而不是特性）
• Avoid administrative distraction（避免行政|管理上的分心）
• Design for failure（容错设计）
• Keep it logically awesome（保持良好的逻辑性）

—— The Zen of GitHub

GitHub 的技术经理 Ben Balter 撰文写道，这些 API 中返回的句子就是 GitHub 的原则。这是 GitHub 服务器每次运行时显示的第一个句子，也是 GitHub 历史上大多数重大决策的基础理念，无论是技术上的还是其他方面的。

这些原则是最早期的时候 Github 第一个设计师 Kyle Neath 写下来的。

基于此，那我们的开发准则呢？或者说开发理念是什么？可以借鉴 The Zen of Github。

• 易于理解比简洁更重要，不要为了简洁而简洁。
• 实用流畅比炫酷更重要，不要为了炫技而炫技。
• 注意命名使用词，不要太随意，它们很重要。
• 任何添加事物都会稀释其他事物。
• 说人话，不要造生僻词，不要故作高深。
• 有效沟通，不说废话，保持信息与认知对齐。
• 善于提问，正确的问题往往比答案更重要。
• 不要半途而废，不要逃避问题。
• 有效并且高效地解决问题排在首位。
• 谋定而后动，不要想当然。
• 容错设计，避免无法挽回的后果。
• 注意兼容，多看多测多考虑。
• 如无必要，避免强制操作。
• 逻辑清晰无漏洞，经得住考验。
• 优先关注焦点而不是特性。
• 用模块化思维，别去重复造轮子。
• 有操作就要有反馈，无论成功或失败。
• 避免阻塞、不可操作的情况。
• 杜绝私下、不透明、不明确的任务。
• 先紧后松，留缓冲时间，避免临阵磨枪。
• 注重文档沉淀，增援未来。
• 避免行政或管理上的分心。
• 遇事不决及时向上反馈。
• Focus on long term impact。(关注长期影响)