Major revamp of the documentation

Preview the built docs: http://xray.readthedocs.org/en/docs-v2/

Feedback would be greatly appreciated!
nit: "an dimension" --> "a dimension"