OSM Documentation Workshop on Diataxis Framework: Difference between revisions

From OSM Public Wiki
Jump to: navigation, search
No edit summary
No edit summary
Line 1: Line 1:
<span style="font-size:180%;"> <div style='text-align: center;'> '''Monday 20th June and Wednesday 22nd June (12:00 - 14:00 UTC)'''</div></span>  
<span style="font-size:180%;"> <div style='text-align: center;'> '''Monday 20th June and Wednesday 22nd June (12:00 - 14:00 UTC)'''</div></span>  
[[File:OSM13_lead_image.jpg|800px|center|top]]       
[[File:book.jpg|800px|center|top]]       


= Overview=
= Overview=

Revision as of 09:15, 17 May 2022

Monday 20th June and Wednesday 22nd June (12:00 - 14:00 UTC)
Book.jpg

Overview

OSM will host a documentation workshop carried by Daniele Procida (Canonical) about the Diátaxis framework. The framework breaks documentation down into 4 main categories:

  • Tutorials (learning-oriented); practical, severs study
  • How-to guides (task-oriented): practical, serves work
  • Explanation (understanding-oriented): theoretical, severs study
  • Reference (technical information): theoretical, serves work

The workshop will consist of two sessions of 2 hours, both theory and practice:

  • Monday June 20th. Part 1 - Quality: introduction to the Diataxis framework: the diátaxis system and how it works
  • Wednesday June 22nd. Part 2 - Execution: getting things done. Authoring practices and approaches.

The format will be a collaborative and interactive workshop, getting things done with minimum effort and maximum results.

Registration

Registration is free of charge and open to all, register here! You are most welcome to invite your colleagues and partners to join us.

Join us

Contact

Please send your technical questions to OSM_TECH@list.etsi.org, OSM Community Slack Workspace or Contact us directly

Questions about ETSI, joining OSM, this and future events can be sent to OSMSupport@etsi.org