Dec2014 docs edits

Please don't merge this yet! There are still a few more commits to get in.

When this is merged, please resolve the following tickets:

* DOC-1465
* DOC-1468
* DOC-1466
Yeah, it's a path on the docs website. There're a couple of cases, mostly on this one page, where we write with the official site in mind and use links that don't work on GitHub. I'm still pondering when this is the right approach. :/