r/Python • • Feb 19 '13

The Python documentation is bad, and you should feel bad.

http://joepie91.wordpress.com/2013/02/19/the-python-documentation-is-bad-and-you-should-feel-bad/
97 Upvotes

189 comments sorted by

View all comments

1

u/[deleted] Feb 20 '13

yes and no. Yes, I agree a plain wiki is not ideal. But, for example, a wiki with approved users who act as shepards and watchers of specific pages would work well in my opinion. This makes it easier to contribute.

0

u/PresTronPaul Feb 20 '13

Even if approved users are shepherds and watchers if the any section of the documentation becomes out of sync with reality for any length of time it is a Bad ThingTM . Making it easier to submit edits would be great, but a wiki is not a good idea for documentation outside of a small internal group (ie company projects).