Docs like code in Drupal
Introducing Open DevPortal, an open source CMS based documentation tool
- Track: Tool the Docs devroom
- Room: UD2.119
- Day: Sunday
- Start: 10:25
- End: 10:55
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
Speakers
Kitti Radovics |