Finished first draft of documentation: both readme and index.rst in docs.
Practically ready for distribution release.