Need some basic documentation
This issue covers two aspects:
- pick the right documenting tool
- come up with some initial skeleton.
Note there are two .rst (sphinx) files in docs/, but that doesn't imply we need to use Sphinx. We can use something else, if we find it more useful. In particular, goswagger supposedly has some documentation generation capabilities that we could use. However, keep in mind that the API documentation is not the only thing that we want. There should be additional elements (software overview, current capabilities, installation instructions, etc)