Message177641
| 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:18 | chris.jerdonek | set | recipients:
+ chris.jerdonek, bethard, ezio.melotti, eric.araujo, sandro.tosi, docs@python, marcs, westley.martinez, tshepang, adam.woodbeck, dlam, groodt |
| 2012年12月17日 10:49:18 | chris.jerdonek | set | messageid: <1355741358.27.0.0235217231344.issue11176@psf.upfronthosting.co.za> |
| 2012年12月17日 10:49:18 | chris.jerdonek | link | issue11176 messages |
| 2012年12月17日 10:49:17 | chris.jerdonek | create |
|