Documentation

The first commit addresses #47 
The three next update the documentation in various ways. This could possibly have been separate request.