Updates to the docs with current best practices.
Authored by: biotelerock 2013-11-20
Parent: [r180]
Child: [r182]
