Some documentation to address part of #32 

Looking forward, we should use redathedocs