PYTHON-525 Update replica set docs for new MongoClient.

Also improve RST markup and fix duplicate reference targets in docstrings.