creates a `tox.ini` file so that testing/CI is easier

Preliminary work is done just for building docs, comments in the `tox.ini` file should be clear about what flags
should be used (but aren't currently) and when we should change that.

Some other minor fixes were done so that builds were a bit cleaner (e.g. add documents to a toctree).