Methods and standards for storing and publishing docs based on projects outside gitlab
We need to clarify and perhaps expand our methods and standards for storing and publishing docs based on projects outside gitlab & gitlab-foss (Gitaly, Runner, Telemetry, Omnibus, Charts, SAST/DAST, others we may want to consider).
Options/methods - some in use today:
- bring in a single /doc path from external repo to top level of site e.g. docs.gitlab.com/runner
- migrate some or all docs to CE (as with SAST and Axil’s MR above)
- New solution re. pulling in specific path from a repo into specific subpath of docs e.g. /doc/administration -> /administration/gitaly
This was inspired by the discussion here around Gitaly gitaly!1421 (merged) but is also relevant to recent discussions around Telemetry (see Related issues)
We may also want to consider whether a layer of analysis/categorization re docs (including the Tech Writing team's role in reviews) should be added on all projects here, or more of them.