How to write a lernOS Guide

Links

• Blog Wie schreibt man einen lernOS Guide
• Beitrag Anforderungen an lernOS Guides und Lernpfade auf CONNECT

Kata Documentation

Katas are the exercises in lernOS. A collection of katas build a learning path that can be used in a learning sprint. Katas can be used by individuals or circles in a self-organized way or in lernOS Dojos in an instructed way. The idea of using katas and dojos in lernOS came from the coder dojo movement and the education of programmers (see book The Pragmatic Programmer: From Journeyman to Master, Affiliate Link").

This short description should help practitioners to create new lernOS Katas, Learning Paths, and Guides. The ideas for structuring katas is derived from the Sushi Cards in Coder Dojos, the wikiHow tutorial collection and the format of the Liberating Structures.

The following elements can be used to document a kata in a structured way. The section "Instruction" can be used to create sushi cards for the kata.

1. Title: the name of the kata. Should be short, precise, and "sticky" (e.g. "Future Backwards").
2. Description: a short description of the kata in one sentence.
3. Duration: the time necessary to run the kata (default: in minutes).
4. Instruction: a numbered list of activities that need to be done in order to run the kata. If necessary the instruction can contain links and/or images (see also Making Sushi Cards).
5. Category: tbd.
6. Difficulty level: Beginner, Intermediate, Advanced