Fixed README and added documentation

Fixed the example at the beginning of the README removing the deprecated
function and calling correctly to add-entity with the monet canvas.

Added documentation of the available functions to be included with its
docstrings and the function signature classified by namespace and
functionality.
Merge pull request #3 from joakin/master

Fixed README and added documentation