[Python-Dev] Style guide for FAQs?
solipsis at pitrou.net
Sat Dec 3 21:39:03 CET 2011
I notice that some FAQs are not only outdated but seem to favour a
writing style that's quite lengthy and full of anecdotal details.
It seems to me that there is value in giving terse answers in FAQs (we
have - or should have - reference documentation where things are
explained in more detail).
One primary example is the performance question:
It mixes a couple of generalities with incredibly specific suggestions
such as early binding of methods or use of default argument values to
fold constants. I think a beginner reading this entry won't get any
meaningful information out of it.
Any advice on whether it's ok to hack and slash into the fat? :)
More information about the Python-Dev