2023-05-31 –, East Drawing Room
In a hands-on workshop I'll introduce some of the tools and methods I have developed to help an organisation improve documentation consistently and effectively, at scale.
At Canonical, I lead documentation practice - the way we (1000+ people working on dozens of projects) do documentation. That means establishing a shared understanding of standards, and how to reach them.
To help do this I have developed a number of tools and methods to help all of us understand our progress and achieve it faster.
In this hands-on workshop I will introduce some of them, and help you start to adapt to your own needs.
I hope that this workshop will be of value to anyone working in an engineering organisation where documentation discipline and success seems harder to obtain than it should be.
I am a Director of Engineering at Canonical, where I lead documentation practice. I enjoy helping organise community conferences for Python and Django, and helping people and open-source projects improve their documentation.
I am the author of the Diátaxis documentation framework, and unless I commit a noteworthy crime I expect that is what I will be best known for.