When documenting software it makes sense to treat your docs like code. Doing so allows documentarians to collaborate much easier with developers. While most teams have chosen for static site generators to implement this methodology, we identified a number of use cases where it would make much more sense to use a CMS based system. In this talk I explain why, and introduce a new open source project, based on Drupal, that can import Markdown and Open API specifications.
What is docs like code
When to use a CMS for your docs
How we built a markdown and Open API importer in Drupal
-current features
Auto filling tags
Validation
CI/CD to submit
-difficulties
-future plans
Use cases
-Developer portals
-Enabling upstream contributions in distribution docs