Introducing the Diátaxis Approach to Technical Documentation

Logo
Presented by

Guest: Daniele Procida > Host: Scott Abel

About this talk

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.
Related topics:

More from this channel

Upcoming talks (67)
On-demand talks (670)
Subscribers (73505)
The Content Wrangler Channel covers the people, methods, tools and technologies designed to help you deliver the right information, to the right people, at the right time, on the right device, in the right format and language. Your content is your most valuable business asset. Let us show you how to manage it efficiently and effectively.