Open Source DocOps

A presentation at FOSDEM 2024 in in Brussels, Belgium by Lorna Jane Mitchell

Every software project has a robust continuous integration/delivery setup, but many of our documentation projects are still playing catchup. In this talk you’ll hear about a selection of tools that are good additions to your documentation pipeline, and how to use them both locally and in CI. We’ll cover linting and validation of your source content, and look at tools that can help with consistent formatting. We’ll also look at content quality tools, such as prose linting, link checking, and more. You’ll see examples of projects that use some or all of these tools in anger, and we’ll also discuss when too many tools is too many! This session is recommended for anyone who works on documentation platforms as either writer or engineer, and wants to make their world better.