Nick Coghlan added the comment:

Likely revised structure:

* Move the high level convenience API back to the first section under a 
subheading like "Common operations"

* Give the new run() function its own subheading like "Flexible command 
invocation"

* Move the exception definitions to the Exceptions subheading

* give the stream constants their own subheading after "Frequently Used 
Arguments"

* consider whether or not the "Using the subprocess module" heading level is 
worthwhile, or whether it makes more sense to pull all its subheading up one 
level

----------
assignee:  -> docs@python
components: +Documentation
nosy: +docs@python
stage:  -> needs patch
type:  -> enhancement
versions: +Python 3.5, Python 3.6

_______________________________________
Python tracker <rep...@bugs.python.org>
<http://bugs.python.org/issue27050>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to