Director of Engineering
I'm a Director of Engineering at Canonical, responsible for documentation - and making sure that ours becomes the best documentation possible. I'm the author of the Diátaxis documentation framework, and a Django core developer.
9 August 2023
Imagine if – as a job applicant – you could put yourself right in front of the hiring lead, and tell them, in your own words, in your own time, without interruption or distraction or pressure, why you think you’d be an excellent person for the role. What kind of applicant would benefit the most? ...
5 October 2022
To help bring our ambitious documentation plans to fruition, we’re going to be hiring people to work in documentation – over the next couple of years, we’ll be increasing the number of Technical Authors at Canonical four-fold. This isn’t about documentation alone. If documentation is part of a product, and documentation work is part of ...
25 January 2022
Sooner or later, almost everyone who looks at some software that they or their team have created imagines a user getting to grips with it, and a pang of empathy for that unknown person prompts them to think: what we need here is a tutorial. And they are always absolutely right. In the Diátaxis documentation ...
15 December 2021
Our on-going documentation transformation project aims to make our documentation the best it can possibly be – an exemplar of excellence for the industry. We’re working on four distinct pillars of documentation to achieve this. The first of these pillars is direction. It defines what is quality in documentation, and answers the question: ...
17 November 2021
Our software documentation is part of how we talk to each other – our users, our colleagues, our community. It’s a way we demonstrate how we value each other – including how we value you. We’ve understood the importance of this for some time, but actually finding a way to express those values in our ...