Steven D'Aprano <steve+comp.lang.pyt...@pearwood.info> writes: > http://mail.python.org/pipermail/tutor/2010-December/080505.html > > > Constructive criticism welcome.
Informative, but it “buries the lead” as our friends in the press corps would say. Instead you should write as though you have no idea where the reader will stop reading, and still give them the most useful part. Write the most important information first, and don't bury it at the end. In this case, I'd judge the most important information to be “what is the Python passing model?” Give it a short name; the effbot's “pass by object” sounds good to me. Then explain what that means. Then, only after giving the actual information you want the reader to go away with, you can spend the rest of the essay giving a history behind the craziness. More on this style: <URL:http://www.computerworld.com/s/article/print/93903/I_m_OK_The_Bull_Is_Dead> -- \ Moriarty: “Forty thousand million billion dollars? That money | `\ must be worth a fortune!” —The Goon Show, _The Sale of | _o__) Manhattan_ | Ben Finney -- http://mail.python.org/mailman/listinfo/python-list