added comments
Merge branch 'crichton_refactoring_documentation' of github.com:mdsol/crichton into crichton_refactoring_documentation