DOC : make use of autolink

 - will auto-link if a word in `` is a class or function
DOC : added explanatory comments to autolink
DOC : added style re one-line if statements

 - Added prose to docs regarding style.
Merge pull request #73 from tacaswell/doc_tweak

DOC : make use of autolink
Merge pull request #88 from tacaswell/if_doc

DOC : added style re one-line if statements