automate subproject metadata parsing

[casperdcl]

• use openworm/*/master/.openworm.y(a)ml
  • review current spec & possibly update
• use openworm/*/master/.openworm.md
  • with optional YAML metadata block (so no *.yml required)
  • introduce developer guidelines on how/what to write/update
  • support injection of sub-groups pages
• support manual definition (top-level config file pointing to subgroup urls & collections)
• support automated definition (crawl all openworm repos for more subgroups with .openworm.*)
• cloud CI (e.g. .travis.yml)
  • pull metadata sources to build http://docs.openworm.org/en/latest/projects/
  • automatically run e.g. daily
• auto-label pages with "last updated TIMESTAMP" based on pulled subproject config modified time

---

• fixes Find way to embed dynamic list of git repos / milestones / issues #33
• fixes Update repositories.md #32

[casperdcl]

@cheelee let me know if this sounds reasonable

[casperdcl]

may have to split this issue into multiple smaller ones and/or small PRs.

[cheelee]

@casperdcl Hi! This looks reasonable. Thanks!

[mwatts15]

Is just to create a blurb for each project repo?

[casperdcl]

an up-to-date blurb (.openworm.yml) to appear on e.g. http://docs.openworm.org/en/latest/projects/ but also optionally a page (.openworm.md) to appear on e.g. http://docs.openworm.org/en/latest/Projects/sibernetic/

both of which subprojects maintain in their own repos, perhaps using their own automation processes.

[casperdcl]

from https://github.com/orgs/openworm/teams/google-season-of-documentation/discussions/2 -

http://docs.openworm.org/en/latest/projects/ has no bad links; but

1. "Data Collection and Representation" is a somewhat loose collection of subgroups
2. "Muscle/Neuron/Channel" is a collection of the work of 3-4 different subgroups.
3. "Optimization engine" is orphaned and should be removed.
4. "Education" should be added with the associated robotics and wormworx tool repos.
5. "Community" needs very serious content updates, and still references deprecated chat channels like Gitter.

-- @cheelee

[casperdcl]

I'll try to use the current http://docs.openworm.org/en/latest/projects/ plus the comment above (#55 (comment)) to come up with snippets (.openworm.yml / .openworm.md) etc to produce a new version of http://docs.openworm.org/en/latest/projects/

[pgleeson]

@casperdcl This info is appearing (and seems to be updating correctly) on https://docs.openworm.org/Community/repositories/. Ok to close or more to do?

[casperdcl]

I think the unticked boxes should ideally still be addressed to unify things a bit better...

[pgleeson]

Understood. Thanks for your continued interest in all this.