On Mon, Sep 23, 2013 at 2:15 PM, Nick Coghlan firstname.lastname@example.org wrote:
With the last round of updates, I believe PEP 453 is ready for Martin's pronouncement.
I'd enjoy concise PEP texts, but it is extremely hard to write one, so is it possible to at least add a TL;DR chapter that just shows the concept in 15 seconds without all the gory details? What is the entrypoint in the bootstrap process and knowledge requirements for the user?
For the same sake, is it possible to include real world usage scenario as a code paste example of user session. For instance:
# --- 001: user reads install instruction on <package> site # 'pip install <package>'
# user executes 'pip install <package>' on Windows
pip install <package>
'pip' is not recognized as an internal or external command, operable program or batch file. # user ...<does what>... ? [ ]
# user executes 'pip install <package>' on Ubuntu $ pip install <package> The program 'pip' is currently not installed. You can install it by typing: sudo apt-get install pip $ sudo apt-get install pip # (user has sudo - done) # user doesn't have sudo, command fails # user ...<does what>... ? [ ]
# --- 002: user reads install instruction on <package> site # 'python -m pip install <package>'
$ python -m pip install <package> /usr/bin/python: No module named pip # user ...<does what>... ? [ ]