add source comments; updated template with changes;
Merge pull request #16 from dysfunc/comments

add source comments; updated template with changes;