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@bugs.python.org> <http://bugs.python.org/issue26889> _______________________________________