move main comment block to top of file; fix some links
edits and some reordering