added small HTML comments
added code documentation to every possible location. closes #2
Merge branch 'issue-2' into devel