[issue3005] EasyDialogs - documentation enhancement
New submission from kee nethery <[EMAIL PROTECTED]>: issue: We spent quite a bit of time trying to figure out why EasyDialogs was not working, no dialogs were appearing. Eventually I had to check an AIM and noticed several icons bouncing in the dock. Scrolled over one and it claimed it was Python, and when selected, displayed the dialog we had been trying to get to appear. A simple sentence explaining how to make the dialog appear would be a useful addition to the documentation. URL for the docs shown below. Existing intro paragraph shown below. Suggested additional sentence shown below. url: http://docs.python.org/mac/module-EasyDialogs.html existing: The EasyDialogs module contains some simple dialogs for the Macintosh. All routines take an optional resource ID parameter id with which one can override the DLOG resource used for the dialog, provided that the dialog items correspond (both type and item number) to those in the default DLOG resource. See source code for details. suggested: The EasyDialogs module contains some simple dialogs for the Macintosh. The dialogs get launched in a separate application which appears in the dock and must be clicked on for the dialogs be displayed. All routines take an optional resource ID parameter id with which one can override the DLOG resource used for the dialog, provided that the dialog items correspond (both type and item number) to those in the default DLOG resource. See source code for details. Thanks, kee nethery -- assignee: georg.brandl components: Documentation messages: 67507 nosy: georg.brandl, keenethery severity: normal status: open title: EasyDialogs - documentation enhancement type: feature request versions: Python 2.5 ___ Python tracker <[EMAIL PROTECTED]> <http://bugs.python.org/issue3005> ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue6660] Desire python.org documentation link to user contribution wiki (per function)
New submission from kee nethery : 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 <http://bugs.python.org/issue6660> ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue6660] Desire python.org documentation link to user contribution wiki (per function)
kee nethery added the comment: Georg, So there will be a link next to each numbered section in the documentation that links to a user editable wiki page about that section? That will be highly useful. Glad to hear it. I know I'd like to contribute the gotchas I was confused by and the sample code snippets that solved a specific generic problem. Having more sample code linked from each numbered section in the docs would make my life easier when trying to learn Python. Kee Nethery On Aug 6, 2009, at 10:56 AM, Georg Brandl wrote: > > Georg Brandl added the comment: > > This is already in planning; Sphinx will grow a webapp system that > also > allows suggestions for changes. > > -- > resolution: -> later > status: open -> closed > > ___ > Python tracker > <http://bugs.python.org/issue6660> > ___ - I check email roughly 2 to 3 times per business day. Kagi main office: +1 (510) 550-1336 -- ___ Python tracker <http://bugs.python.org/issue6660> ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue6660] Desire python.org documentation link to user contribution wiki (per function)
kee nethery added the comment: awesome. looking forward to it. Kee On Aug 6, 2009, at 3:38 PM, Georg Brandl wrote: > > Georg Brandl added the comment: > > There will be comments for each function/class etc., as well as a > feature to suggest a change for the proper text of a section. > > -- > > ___ > Python tracker > <http://bugs.python.org/issue6660> > ___ - I check email roughly 2 to 3 times per business day. Kagi main office: +1 (510) 550-1336 -- ___ Python tracker <http://bugs.python.org/issue6660> ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue6660] Desire python.org documentation link to user contribution wiki (per function)
kee nethery added the comment: Is there anything I can do to help this happen? Am thinking that these are the steps to the process. 1. Create wiki.docs.python.org using the wiki setup template already used by wiki.python.org. 2. Lock page creation except for one specific account. 3. Create a template wiki page that has all the subsections desired (one per language version) 4. Grab all the existing docs for say version 2.5 moving forward, and at each perma-link, add a user contributions wiki link. 5. Keep track of all the user contribution wiki links 6. spin through the list of links and generate all the empty user contribution wiki pages. 7. release the docs with the new user contributions wiki links. I'm not a wiki expert but I'd be happy to build the thing that creates each user contribution wiki link in the docs. Then I could pass the modified document files back to you. You could verify they are as desired. Once that looks good I could have code that spins through the links and creates the pages in the wiki. Kee Nethery > From: Georg Brandl > Date: August 6, 2009 3:38:33 PM PDT > To: k...@kagi.com > Subject: [issue6660] Desire python.org documentation link to user > contribution wiki (per function) > Reply-To: Python tracker > > > Georg Brandl added the comment: > > There will be comments for each function/class etc., as well as a > feature to suggest a change for the proper text of a section. > > -- > > ___ > Python tracker > <http://bugs.python.org/issue6660> > ___ -- ___ Python tracker <http://bugs.python.org/issue6660> ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue6660] Desire python.org documentation link to user contribution wiki (per function)
kee nethery added the comment: No problem. I can parse text in an automated manner very easily. So if you need someone to take the doc files and add in wiki URLs for each section, I can do that. Happy to volunteer. Worst case is you look at what I do and reject it. Best case ... I actually do what you need. Thanks, Kee On Aug 24, 2009, at 10:26 AM, Georg Brandl wrote: > > Georg Brandl added the comment: > > At the moment, I still have to review and merge the SoC branch, so > don't > expect visible changes to happen within a few weeks. > > -- > > ___ > Python tracker > <http://bugs.python.org/issue6660> > ___ - I check email roughly 2 to 3 times per business day. Kagi main office: +1 (510) 550-1336 -- ___ Python tracker <http://bugs.python.org/issue6660> ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
