some small code tweaks and more docs
fix broken links
Merge pull request #1 from courtf/notes-sample

Mostly docs