Brussels / 3 & 4 February 2018


Docs like code in Drupal

Introducing Open DevPortal, an open source CMS based documentation tool

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


Kitti Radovics