[New-bugs-announce] [issue6660] Desire python.org documentation link to user contribution wiki (per function)
kee nethery
report at bugs.python.org
Thu Aug 6 19:49:44 CEST 2009
New submission from kee nethery <kee at kagi.com>:
Proposal: For each permalink headline in the official documentation,
link to a wiki page specific to that headline. Allow users to easily
view and contribute comments and examples around that specific
documentation headline. For example:
http://docs.python.org/reference/lexical_analysis.html#string-literal-
concatenation
would have an auto-generated link in the main docs of (for example):
http://wiki.docs.python.org/2.6.2#reference#lexical_analysis.html#string
-literal-concatenation
Easy to create, self administering, perhaps valuable to new users,
completely unofficial.
Newbies need examples, lots of examples. Newbies have noob questions
about things they are stumbling across that experienced users have
forgotten was once confusing. For experienced users that knowledge is
now part of their Python DNA. According to people on the "python-list"
other languages have wiki style user contribution areas that allow
newbies to document the things they found confusing (and the answers)
and to provide lots of code examples. Periodically this newbie
information is rolled back into the official mainline docs. Requiring
newbies to join this tracking system and to submit bugs is just way to
complex for something that is now trivial to do with a wiki and it
obviously causes the new user contributions to be pretty non-existent.
Python would be a much easier language to learn if newbies could easily
contribute through the main documentation web site.
----------
assignee: georg.brandl
components: Documentation
messages: 91373
nosy: georg.brandl, keenethery, nnorwitz
severity: normal
status: open
title: Desire python.org documentation link to user contribution wiki (per function)
type: feature request
versions: Python 2.6, Python 2.7, Python 3.0, Python 3.1, Python 3.2
_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue6660>
_______________________________________
More information about the New-bugs-announce
mailing list