Writing documentation isn’t fun, but it is important. Important for it to exist and to be accurate. Personally, I find keeping documentation up to date to be very difficult. For this reason, it’s important to work smarter, not harder when documenting your library.
Here are a few tips:
The first page of your documentation is likely to be pretty much the same as the README you have in your package repository. Why not save yourself the trouble of trying to keep that in sync by simply using a rST include directive. If your docs live in the docs folder then the following should do the job nicely:
.. include:: ../README.rst
Of course, if you aren’t yet using reStructuredText to format your README, then this won’t work. Perhaps it’s time to consider a change?