Tag: 文档

最近有一个项目做了一半不做了，准确地说是由于某些原因，项目需要别的团队来接手了，于是我想随便聊聊这个话题。我猜想，“项目做一半撒手”，这应该是一个很常见的现象，因为这样的事情无论大厂小厂，在软件的世界里不断上演。具体来说，有这样几种典型的情况：

• 业务变动、组织调整，工作重心变了，项目做了一半直接砍掉，或者无限期停工。这大概是最常见的一种情形。
• 由于前期的调研、设计的严重问题，或是市场等变化过于剧烈，项目做不下去了，静悄悄地黄了。
• 项目还做，但是转交给某个其它的团队，这是我这一次遇到的情形。项目还存在，只不过所属关系已经发生变更。

文档和隐性成本

无论哪一种，有一点 [……]阅读全文

还记得在 2008 年我做毕业设计的时候，自己心里有一个朦朦胧胧的概念，大概是说，要规范，制度上有标准，流程上有遵循。于是噼里啪啦整了软件工程十项文档，再加上一些辅助性文档就有了下面这个清单。我以为那样的全面会带来更好的评价，但是老师说，“太多了”，我很困惑，难道文档全面、综合，而且完备，这不好么？

在 Amazon 有一个大家都知道和反复自黑的事情。所有 team 都用 wiki 来记录和维护项目、产品有关的事情，但是绝大多数 wiki 的内容都是过时的和不准确的。有几次和其他互联网公司的朋友讨论过这个话题，大家都付诸呵呵一笑，原来大家都差不多。这让我思考，是不是文档这样的东西，和代码不同，它更容易过时，它

[……]阅读全文