Added note to quick-start guide to try and prevent package vs source installation confusion. Fixed several documentation build issues.


Added note to quick start guide at the very top to ensure developers don't use package install. Fixed several broken internal sphinx references.

fix gh592
This might be better as a warning: http://sphinx-doc.org/markup/para.html#directive-warning