Improve data docs

Second iteration
Merge pull request #148 from bodepd/data_doc_update

Improve data docs