Documentation suggestions

Rhamphoryncus rhamph at gmail.com
Tue Dec 6 23:28:02 EST 2005


A.M. Kuchling wrote:
> Here are some thoughts on reorganizing Python's documentation, with
> one big suggestion.

Throwing in my own 2¢.. I think the language reference should be
disseminated into the rest of the documentation.  Some of the stuff
(operator precedence anybody?) could be done directly, while more
technical aspects could be put in boxes with green[0] backgrounds
saying "technical details".  Thinks specific to one implementation
could further be given a blue[0] background.

I don't expect everything to make the transition.  Are discussions of
"atoms" and fragments of BNF really better than calling them
expressions and linking to CPython's Grammar file?

--
Adam Olsen, aka Rhamphoryncus

[0] Colors pulled off the top of my head




More information about the Python-list mailing list