2023-09-23 –, Room B
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 adaptable 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, in your own organisation.
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.