Add documentation pages

The current documentation via the Readme is fine, but fairly long, and somewhat incomplete.

This setup should be moved to Documenter.jl, also rebuilding the performance plots when deploying on master, but by default not on MRs.

See https://stackoverflow.com/questions/36191766/metaprogramming-within-docstring-with-eval for adding DocStrings.