[issue25822] Add docstrings to fields of urllib.parse results

Martin Panter report at bugs.python.org
Fri Dec 11 23:59:21 EST 2015


Martin Panter added the comment:

[padding]
I left some comments.

I wonder if the doc strings are too specific when they mention “request”, “file”, “download”, “page”, etc. Maybe these could just be examples of what the fields are used for (e.g. “The hierarchical path, such as the path to a file to download”). Or maybe they could be changed to general terms, but this may be hard.

Also, some of them seem redundant. Does it really add anything to say the “query” field is “the query parameter”?

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue25822>
_______________________________________


More information about the Python-bugs-list mailing list