[WIP] Documentation on data_specs and spaces

Here is the documentation on data_specs, how they work and how they are currently used.
Feel free to review and comment on it, I still have to check the RST syntax and sphinx links.