Major revamp of the documentation

Preview the built docs: http://xray.readthedocs.org/en/docs-v2/

Feedback would be greatly appreciated!
The difficulty is that we need a way to distinguish between coordinate names and coordinate objects. I was using `dimension` (or `dim`) as a shortcut for the former.