PyCon UK 2022

Introduction to Diátaxis
09-18, 11:00–12:30 (Europe/London), Room C

Over the last year, the Diátaxis documentation framework has taken off in popularity. This workshop provides a brief introduction to the framework, and includes a number of hands-on exercises. It will be useful for anyone who has to work with software documentation.


I have run this workshop about 20 times in the last year; it's thoroughly road-tested with a wide range of audiences.

It gives participants the opportunity to work though key aspects of the Diátaxis framework in a structured, collaborative context.

I'm a Director of Engineering at Canonical, where I am working to transform documentation practice across 40-plus engineering teams. I love documentation, Python and PyCons.

I am the author of the Diátaxis documentation framework, a core developer of the Django Project since 2013 and I served as Vice President of the Django Software Foundation for several years.

I've been involved in the African Python movement for several years. I have attended multiple PyCons in African countries, and I was part of the organising team that held the first PyCon Africa in Ghana in 2019.

This speaker also appears in: