Document classes and functions

[danilomo]

Currently the project has zero docstrings. It is important, for an API, that each method and class be well documented.

We should make an effort to document the current classes and functions in the project, and require that new public API types and functions be documented before being committed to master.

[mateusrangel]

With proper docstrings we could have a documentation generated with some tool like sphinx.