complete external documentation, re #3

This includes general information, important links, installation and
usage.

Most of the (internal) docstrings are still missing,
which would be included in the sphinx documentation automatically.

[ci skip]