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 -- http://mail.python.org/mailman/listinfo/python-list
