Improving documentation

This helps knowing where base classes and interfaces live, also fixed one syntax error in the examples
Merge pull request #42 from lorenzo/patch-1

Improving documentation