Summarise Diataxis in 'Updating the Guidebook'
Since Diataxis is used in the structuring of the Guidebook, update the Guidebook to reference this approach for future record.
Suggested content, to be added to https://guidebook.devops.uis.cam.ac.uk/en/latest/#updating-the-guidebook:
Information Layout
Principal navigation sections of the guidebook reflect principles of Diátaxis.
Diátaxis is a systematic approach to technical documentation authoring.
It identifies four distinct user needs and four corresponding forms of documentation:
Tutorials: Teach a general skill or concept through a step-by-step learning experience.
How-To Guides: Help users accomplish a specific task or achieve a particular outcome.
Reference: Provide comprehensive information about the technical details, features, and functionality.
Explanation: Offer deeper understanding of the underlying principles, design, or rationale.
For more information, see https://diataxis.fr/ .