Documentation

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