Page MenuHomeSoftware Heritage

proposal: sysadm docs: Move relevant and public doc from intranet to swh-docs
Open, NormalPublic

Description

Proposal

After discussion the following structure emerged as proposal for the sysadm pages.

A new page [1] to add the documentation site. This could be publicly linked from the
main page [2] (or not). This could also be publicly exposed (or not as the current
intranet which is http-basic protected for example).

Pros/cons

pros

  • code review ahead of time available (one could always skip it if they don't want to)
  • tool unification (sphinx rst, git, ...)

cons

No cons that I can see (well the migration per say but that can be done incrementally :)

Remaining pages to redispatch eventually

[1] https://docs.softwareheritage.org/sysadm/

[2] https://docs.softwareheritage.org/