Improve docs

[paxcema]

Right now, documentation is in a very preliminar and rough state.

Any help towards making it easier to understand the codebase and the purpose of the package will be of great help.