fix a bunch of warnings and errors. Among other things, this
ensures that the broken links are working.
Merge pull request #106 from continuuity/feature/doc-warning-cleanup

fix a bunch of warnings and errors. Among other things, this