Introduction to Diátaxis
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.