敏捷了还要文档吗？

感觉不是demo，demo是是到示范作用的，我做的就是要用到实际应用中的。

什么叫必要？怎么判断是否必要？
你用不上就叫不必要？
你们公司从来不用就叫不必要？

撰写有必要的文档是必须的。

一个项目，文档是它的一部分，你说用不用写。
如果你买一个产品，连一个产品规格都没有，你觉得你能接受吗。
如果自己学习用，随便你怎么做，文档啊，设计啊，都可以不考虑。如果是做项目，先做好设计，别以为敏捷开发就不设计了，不要这么幼稚。

本本主义害死人
需求文档->概要设计文档->详细设计文档->操作手册...
这是我们从软件工程教材上学的,好像少做一步这个项目就会完蛋一样,但实际项目中有些文档完全没有必要
实际的情况是在项目前期你会花大量的时间来做设计文档,而在项目进行后,对需求的更改和会对设计才生很大的影响,这时候一般都不会再去维护设计文档了,而是直接更改代码,设计文档完全失去了它的意义

刚看了<代码即是设计>,很赞同这种观点,

刚看完书才这样说。你能写出这样的代码吗？至少我还没有见过。
现在的社会，现在的人们，浮躁的社会，浮躁的人们，真正有代码即是设计的人，少之又少，真的有这样的人， 也已不做编码了。

如果设计文档只是做一次就不维护的话，还不如不做。
但是没有文档的程序，以后有修改如何办？全部去看代码，不现实。

敏捷了,产品快出了,但由于文档不全不规范,久了就回忆不起具体过程和原理了,不便维护

TW里的文档大多数都是什么样的文档？需求?设计?用户手册？还是其它的？

在scrum开发过程中， 需求文档以一个个story的形式存在，没有详细设计文档，用户手册取决于用户是否需要。

我认为，xp开发不写注释的基础是，代码本身已经优秀到不需要额外的文档就可以让别人读懂。如果保证不了代码的优雅，还是写点注释吧。

另外，对于一些构架的设计，我还是觉得需要一些文档，比如一个复杂的状态机，如果没有一个文档来描述状态的流转，在开发中很容易出现一些不合法的状态流转，开发人员的思路也容易混乱。