Documentation on data_specs and spaces

Here is the documentation on data_specs, how they work and how they are currently used.
RST syntax and sphinx links have been fixed thanks to @vdumoulin.

If there are no major problems, I would like to merge before the end of the week.