Diataxis Executable Book (diaexbook), SS 2026

Diataxis Executable Book (diaexbook), SS 2026#

Teilnahmevoraussetzung: Sie haben einen Laptop (ggf. ausleihen etc.), auf dem unter Virtualbox das dsci-lab läuft. (Und nein, sorry: Sie werden es nicht schaffen, die erforderliche Software selbst auf Ihrem Rechner zu installieren und zu konfigurieren – nicht mit vernünftigem Aufwand, nicht stabil, und schon gar nicht unter Windows. Die Bereitschaft Linux zu benutzen wird vorausgesetzt.)

Lernziele im Seminar#

Wir machen in diesem Seminar die “modernen Medien” aus der Modulbeschreibung des Seminars IF640 selbst zum Thema. Auftrag an das Seminar im Bachelor-Studiengang laut Modulhandbuch:

Qualifikationsziele: Die Studierenden sind in der Lage sich ein komplexes fachliches Thema aus der Literatur selbstständig zu erarbeiten. Sie können das Thema in einem fachlichen Vortrag unter Zuhilfenahme moderner Medien präsentieren und mit einem technisch versierten Publikum eine Diskussion über die Präsentations-Inhalte führen. (Modulbeschreibung IF640)

Im Seminar lernen wir:

“komplexes fachliches Thema” bedeutet:

  • eigenständige Recherche

  • Fokussierung und Abgrenzung

  • inhaltliche Durchdringung

“aus der Literatur”:

  • in der akademischen Wissenschaft: wissenschaftliche Aufsätze

  • in der Praxis der Informatik: vor allem Online-Dokumentationen, insbesondere von Software-Bibliotheken

“moderne Medien”: Früher waren ppt-Slides einmal ein modernes Medium. Sie sind es auch heute noch in Communities, in das Äußere Seriosität signalisiert und bunte Farben ein relevanter Teil des “professionellen” Auftretens sind.

Wer dagegen heute eine nachhaltige Wissenskommunikation anstrebt, stellt Wissen nicht in Slides und als pdf, sondern in Form einer technisch offenen und inhaltlich professionell erschlossenen Website dar. Das gilt um so mehr in Kontexten, in denen man es auch mit Daten bis hin zu lauffähigem Code zu tun hat. Teilweise stellt der Code selbst das zu präsentierende Artefakt dar; oder lauffähiger Code liest Daten ein und erzeugt automatisch komplexe Reports, die mittelfristig unsere “Präsentationen” im alten Stil ablösen werden.

Seminarthema#

In dem Seminar erarbeiten wir und die methodischen und technologischen Grundlagen für die Erstellung moderner, interaktiver Software-Dokumentation im Netz. Im Zentrum steht die Synthese aus dem strukturellen Framework Diátaxis und der technologischen Umsetzung mittels Executable Books.

Transfer: Letztlich beschäftigen wir uns hier auch mit der Frage, wie eine professionelle Struktur und Dokumentation einer Bachelorarbeit aussieht, in der Code ein relevanter Teil der Problemlösung darstellt. Weitergehend diskutieren wir hier Techniken und Strukturen, wie Begriffe, Abläufe, Regularien einer digitalisierten Verwaltung professionell publiziert werden können. Dieses IF-Seminar ist damit auch für DVM-Studierende geeignet.

Themen NEU 2026-03-30: siehe diaexbook: Themem und Termine

Die Studierenden sind nach Abschluss des Seminars in der Lage:

  • komplexe technische Sachverhalte zielgruppengerecht nach dem Diátaxis-Modell zu strukturieren.

  • interaktive Dokumentationen zu entwickeln, die Code und Theorie nahtlos integrieren.

  • Moderne dokumentations-Workflows unter Linux sicher zu bedienen.

  • Qualitätskriterien für “Anspruchsvolle Dokumentation” (Präzision, Navigierbarkeit, Reproduzierbarkeit) anzuwenden.

Ausarbeitung#

Qualifikationsziele: Die Studierenden … können das Thema … unter Zuhilfenahme moderner Medien präsentieren (Modulhandbuch)

Wie im Modulhandbuch beschrieben: Am Ende steht eine fachliche Präsentation eines der o.A. exemplarisch skizzierten Themen. Man präsentiert das Thema aber nicht als ppt-Show, sondern erzeugt eine Guided Tour, mit der man die Zuhörer durch eine gemäß Diataxis hergestellte Website führt.

Die Studierenden erhalten zu diesem Zweck eine ausführliche Einführung in eine funktierende legacy Basis-Technik (Jupyter Book 1): Im dsci-lab läuft das out of the box. Wer sich die Software selbst installieren will (oder muss: Mac M Prozessor!) darf das gerne versuchen.

Contents