Self documenting project page

Add documentation to README and other places so that the gitlab project page can become the home of the documentation.