Pythondocs.info：协作Python文档项目 [英] Pythondocs.info : collaborative Python documentation project
问题描述
我对当前的Python在线文档有点失望。我已经阅读了许多人抱怨文档的消息，
它缺少例子和使用复杂的句子你
在理解它意味着什么之前需要阅读10次。
这就是为什么我开始一个协作项目来创建用户
贡献的Python文档。维基在线：
http://www.pythondocs.info
这是一个全新的网站，所以没有太多内容，但我希望
让它快速增长。欢迎提供帮助和贡献;请
注册并开始发布自己的文档。
问候，
Nicolas。
-----
http://www.pythondocs.info
ni *******@gmail.com 写道：
我看过许多人抱怨文档的消息，
它缺乏例子和使用复杂的句子，你需要阅读10次才能理解它的含义。
你在哪里读到的？
wildemar
ni ******* @ gmail.com 写道：
我对当前的Python在线文档有点失望。我已经阅读了许多人抱怨文档的消息，
它缺少例子和使用复杂的句子你
在理解它意味着什么之前需要阅读10次。
这就是为什么我开始一个协作项目来创建用户
贡献的Python文档。维基在线：
http://www.pythondocs.info
这是一个全新的网站，所以没有太多内容，但我希望
让它快速增长。欢迎提供帮助和贡献;请
注册并开始发布自己的文档。
虽然我全都赞成改进Python的文档，但我是不是
确保以这种方式分割它是一个好主意。难道你不能把b $ b用于改善docs.python.org上的文档吗？毕竟，
是一个开源项目...
问候
Steve
-
Steve Holden +44 150 684 7255 +1 800 494 3119
Holden Web LLC / Ltd http://www.holdenweb.com
Skype：holdenweb http://holdenweb.blogspot.com
最近的Ramblings http://del.icio.us/steve.holden
Wildemar Wildenburger写道：
ni *** **** @gmail.com 写道：
我看过许多人抱怨文档的消息，
它没有例子和使用复杂的句子你/ b $ b在理解其含义之前需要阅读10次。
>
你在哪里读到的？
wildemar
我不是故意要对此展开一场火焰战争，但这里有一些
参考人们，他们喜欢我，不喜欢当前的python doc：
http://xahlee.org/UnixResource_dir/writ/python_doc.html
http：//mail.python .org / pipermail / pyt ... ay / 280634.html
....
你真的可以在网上找到几十个这样的讨论。
我认为PHP文档相比之下非常好。
Nicolas。
Hi,
I am a bit disapointed with the current Python online documentation. I
have read many messages of people complaining about the documentation,
it''s lack of examples and the use of complicated sentences that you
need to read 10 times before understanding what it means.
That''s why I have started a collaborative project to make a user
contributed Python documentation. The wiki is online here:
http://www.pythondocs.info
This is a fresh new website, so there''s not much on it, but I hope to
make it grow quickly. Help and contributions are welcome; Please
register and start posting your own documentation on it.
Regards,
Nicolas.
-----
http://www.pythondocs.info
ni*******@gmail.com wrote:I have read many messages of people complaining about the documentation,
it''s lack of examples and the use of complicated sentences that you
need to read 10 times before understanding what it means.
Where have you read that?
wildemar
ni*******@gmail.com wrote:Hi,
I am a bit disapointed with the current Python online documentation. I
have read many messages of people complaining about the documentation,
it''s lack of examples and the use of complicated sentences that you
need to read 10 times before understanding what it means.
That''s why I have started a collaborative project to make a user
contributed Python documentation. The wiki is online here:
http://www.pythondocs.info
This is a fresh new website, so there''s not much on it, but I hope to
make it grow quickly. Help and contributions are welcome; Please
register and start posting your own documentation on it.
While I am all in favor of improving Python''s documentation I am not
sure that fragmenting it in this way is a good idea. Couldn''t you
instead devote your efforts to improving the docs at docs.python.org? It
is, after all, an open source project ...
regards
Steve
--
Steve Holden +44 150 684 7255 +1 800 494 3119
Holden Web LLC/Ltd http://www.holdenweb.com
Skype: holdenweb http://holdenweb.blogspot.com
Recent Ramblings http://del.icio.us/steve.holden
Wildemar Wildenburger wrote:ni*******@gmail.com wrote:I have read many messages of people complaining about the documentation,
it''s lack of examples and the use of complicated sentences that you
need to read 10 times before understanding what it means.
>Where have you read that?
wildemarI don''t mean to start a flame war about this but here are some
reference of people, who like me, don''t like the current python doc:
http://xahlee.org/UnixResource_dir/writ/python_doc.html
http://mail.python.org/pipermail/pyt...ay/280634.html
....
You really can find dozens of such discussions on the net.
I think the PHP documentation is a really good one in comparison.
Nicolas.
这篇关于Pythondocs.info：协作Python文档项目的文章就介绍到这了，希望我们推荐的答案对大家有所帮助，也希望大家多多支持IT屋！
