What Fredrik hacks together there (http://www.effbot.org/lib) is very 
impressive. I especially like the "permalinks" in this style:

http://effbot.org/lib/os.path.join

What I would suggest (for any new doc system) is a "split" view: on the left, 
the normal text, on the right, an area with only the headings, functions, 
example and "see also" links (which preferably stays in sight). This way, you 
always keep the outline in view.

Of course, I wouldn't say no to a user-commenting system, but this would have 
to 
be moderated.

What I'm also curious about regarding the current docs, why are optional 
arguments in function declarations not written in Python style?

regards,
Georg

PS: Fredrik, if I can help you, please tell me!

_______________________________________________
Python-Dev mailing list
Python-Dev@python.org
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: 
http://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com

Reply via email to