[Python-Dev] cpython: PEP 417: Adding unittest.mock (original) (raw)
"Martin v. Löwis" martin at v.loewis.de
Mon Mar 19 02:19:20 CET 2012
- Previous message: [Python-Dev] cpython: PEP 417: Adding unittest.mock
- Next message: [Python-Dev] cpython: PEP 417: Adding unittest.mock
- Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]
The commingling of extensive examples with regular docs has made it difficult to lookup functionality in argparse for example.
I have now come to think that this should be considered a subordinate use case. The primary use case of the documentation should be copy-paste style examples. At least, that's the feedback I always get for the Python documentation (typically contrasting it with the PHP documentation, where the specification-style portion is typically ignored by readers, which then move on to the user-contributed examples).
Regards, Martin
- Previous message: [Python-Dev] cpython: PEP 417: Adding unittest.mock
- Next message: [Python-Dev] cpython: PEP 417: Adding unittest.mock
- Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]