bpo-30420: Document the cwd argument to check_output and check_call by alex · Pull Request #1685 · python/cpython (original) (raw)

+1 for adding cwd to the "Frequently Used Arguments" section: https://docs.python.org/3/library/subprocess.html#frequently-used-arguments

In addition to check_call and check_output, it should also be listed in the signatures for call and run.

Regarding the general concern, I started writing a longer reply here, and then realised I would be better off just filing an issue and posting the relevant details there: http://bugs.python.org/issue30420

Basically, I think we have pretty solid (albeit anecdotal) evidence that our current approach to making these docs less overwhelming is genuinely misleading people as to the available API options, and we need to tweak things accordingly.