开源软件设计文档

meteorite

开源软件有需求说明和设计，开发之类的文档吗（除了代码中的说明）？

pingz

just for fan...

你觉得当初Linus会写什么需求说明吗？开发文档的话，至少api文档现在都是写在代码中的。至于其它的文档，基本上都是教程和demo。有些项目可能还会搞些wiki、blog之类的，更大型的项目会有比较清楚的roadmap。这些当然都是文档。说实话，python其实是很狠的……一般的语言不过是应用时要求代码的风格，但是python的代码风格直接是语言的一个部分……包括docstring在内都是官方的要求……其实python的风格就是大部分开源软件的风格……简言之，注释写的比代码还多，代码中的注释就是文档。

所以，如果代码中的“说明”不算文档，那开源软件几乎都没有文档了……

meteorite

额，那要从整体上理解代码不是挺麻烦吗。