[docs] [issue26889] Improve Doc/library/xmlrpc.client.rst
Terry J. Reedy
report at bugs.python.org
Fri May 6 14:43:09 EDT 2016
Terry J. Reedy added the comment:
This is my first reading of this doc. The formatting improvements look good. A definite enhancement.
Review contains a few comments. My main difficulty is separating creation of a proxy instance from use of a proxy instance. Some of the creation parameters govern the use, and hence do not make must sense until one reads the instance description a few paragraphs further on.
Perhaps the initial sentence "A :class:`ServerProxy` instance is an object that manages communication with aremote XML-RPC server." should be expanded into a paragraph with some of the description given later.
----------
nosy: +terry.reedy
_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue26889>
_______________________________________
More information about the docs
mailing list