Author chris.jerdonek
Recipients adam.woodbeck, bethard, chris.jerdonek, dlam, docs@python, eric.araujo, ezio.melotti, groodt, marcs, sandro.tosi, tshepang, westley.martinez
Date 2012-12-17.10:49:17
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1355741358.27.0.0235217231344.issue11176@psf.upfronthosting.co.za>
In-reply-to
Content
Also see this e-mail to docs@:

http://mail.python.org/pipermail/docs/2012-December/012028.html

> Subject: [docs] FOO and BAR
>
> Do you think it would be possible to write your documentation avoiding the silly usage of FOO and BAR everywhere? This is a very very old and boring joke, and does nothing to clarify what you are trying to clarify. If you could include real-world examples in your documentation, rather than "clever" programmer "jokes", learners such as myself would have far more respect for the good work you are obviously doing here.
>
> For example, the section on argparser is full of this sort of rubbish:
> argparse.ArgumentParser(description='A foo that bars')
>
> Under what circumstances would you ever put that in a program? Are you mad?
>
> Please take this into consideration.
History
Date User Action Args
2012-12-17 10:49:18chris.jerdoneksetrecipients: + chris.jerdonek, bethard, ezio.melotti, eric.araujo, sandro.tosi, docs@python, marcs, westley.martinez, tshepang, adam.woodbeck, dlam, groodt
2012-12-17 10:49:18chris.jerdoneksetmessageid: <1355741358.27.0.0235217231344.issue11176@psf.upfronthosting.co.za>
2012-12-17 10:49:18chris.jerdoneklinkissue11176 messages
2012-12-17 10:49:17chris.jerdonekcreate