Improving documentation

This helps knowing where base classes and interfaces live, also fixed one syntax error in the examples