Issue 18 - Improving documentation

This is part of the moving documentation initiative pointed in issue #8.