Author keenethery
Recipients georg.brandl, keenethery, nnorwitz
Date 2009-08-06.17:49:42
SpamBayes Score 2.88747e-09
Marked as misclassified No
Message-id <1249580984.63.0.922866340136.issue6660@psf.upfronthosting.co.za>
In-reply-to
Content
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.
History
Date User Action Args
2009-08-06 17:49:44keenetherysetrecipients: + keenethery, nnorwitz, georg.brandl
2009-08-06 17:49:44keenetherysetmessageid: <1249580984.63.0.922866340136.issue6660@psf.upfronthosting.co.za>
2009-08-06 17:49:43keenetherylinkissue6660 messages
2009-08-06 17:49:42keenetherycreate