Doc environment variables 593

fixes #593 
fixes #460 
There's a standard ReST syntax for "Note"....something like `:note::` http://sphinx-doc.org/markup/para.html#directive-note