Introducing the Diátaxis Approach to Technical Documentation

The Diátaxis approach (https://diataxis.fr/) has become popular in recent years. It brings rigour and clarity, without imposing complex demands on documentation creators, and solves real documentation problems. As a system, it’s built up of simple principles that have immediate practical value. During this free, one-hour web presentation, Daniele Procida, Director of Engineering at Canonical, introduces the approach and discusses its application in different documentation contexts. Daniele will cover: * the four distinct modes of documentation proposed in Diátaxis * how to address user needs systematically in documentation * ideas of “quality” in documentation * rules and heuristics, and methods of applying them * how this works in real-world, practical contexts At Canonical, Daniele leads the documentation practice - a long-term project to transform documentation at scale, across tens of engineering teams, hundreds of products and more than a thousand colleagues with documentation responsibilities. His aim is to establish documentation as a first-class engineering practice. Daniele is also involved in open-source software and communities, particularly in Python, and in the growing pan-African Python movement. Daniele serves an organiser of what will be the first DjangoCon Africa, in November 2023. Can’t make it? Register, and we’ll send you a link to watch a recording when convenient. This web presentation is brought to you by The Content Wrangler and is sponsored by Heretto, a powerful component content management (CCMS) platform to deploy help and API docs in a single portal designed to delight your customers.