[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