Add a full documentation of how to use the code

[melvinstorbacka]

A long-term goal of adding documentation as the library takes shape.