Fill in details on all citations in datasource description page

[travs]

Raised from Padraig's point here.

We need to make the datasource description page more rigorous, adding things like:

• citations of original references
• discussion of labs involved
• explanation of decisions we made about the datasources
• Add in citation for the new connectome spreadsheet being integrated

@pgleeson Please edit this post or comment with additional specs for what should be included in this page other than what I have listed.

[pgleeson]

Looks good so far...

Btw, I thought the documentation had been translated to markdown at some stage..?

[travs]

@pgleeson In some other repos it has, but not here because of the heavy usage of docstrings/autodocs. When Mkdocs supports this (specifically, the version that RTD is using), we can switch over easily.

[slarson]

@pgleeson Check out the latest. I've fleshed it out considerably. I don't know what kind of standard you are looking for in terms of "discussion of labs involved". Could you give an example in the context of what's there now?

[pgleeson]

@slarson That's certainly more like what's needed. It would be great to:

• get this page on (or at least more visible on) the main docs site, e.g. prominently on http://docs.openworm.org/en/0.9/Projects/datarep/
• link to this from the page for scientists: http://www.openworm.org/science.html

See openworm/CElegansNeuroML#49 for discussion on using the new connectome in c302 etc.

[slarson]

OK, great! Closing this one for now. Those suggestions have been moved into issues on their own repos over here:

openworm/openworm.github.io#60 openworm/openworm_docs#37