这是一个创建于 4786 天前的主题，其中的信息可能已经有所发展或是发生改变。
我觉得无论是英文还是中文文档，最重要的是清晰和简洁。
pocoo[0] 的文档就是一个很好的例子。
另外有些文档大而全，但是看起来不着边际，入门很难；但是当你认真去斟酌其字字句句之后会醍醐灌顶，大有收获。
sqlalchemy[1] 就是这类的典型代表。
不知道各位认为怎样去写、翻译文档才是最好的呢？
[0] http://flask.pocoo.org/
[1] http://www.sqlalchemy.org/docs/
pocoo[0] 的文档就是一个很好的例子。
另外有些文档大而全，但是看起来不着边际，入门很难；但是当你认真去斟酌其字字句句之后会醍醐灌顶，大有收获。
sqlalchemy[1] 就是这类的典型代表。
不知道各位认为怎样去写、翻译文档才是最好的呢？
[0] http://flask.pocoo.org/
[1] http://www.sqlalchemy.org/docs/
 |
1
Livid MOD |
 |
2
hbc OP @Livid 没有废话这点异常赞同，在看 Dive into HTML5 将近全书完毕的时候，最终还是忍受不住作者那种罗嗦的口吻，而放弃继续阅读剩下的几个章节了。
|
 |
3
flyingkid 2011-10-22 18:04:07 +08:00
google的帮助中心。
m$ mozilla |
Select Language