# [About these notes]{.en}[À propos de ces notes]{.fr}[Über diese Notizen]{.de} {#sec-about .unnumbered} ::: {.en} These notes summarise the tutorial **“SIN.04028 — From Calling to Eventing”**, worked through step by step. The tutorial itself lives next to this book, in `SIN.04028-From-Calling-to-Eventing/README.md`, and belongs to the *Process Control* course given by Reto Konig at the University of Fribourg (autumn semester 2026). The program under construction never changes: you type a line, it comes back rotated by 13 letters. ```text keyboard → ROT13 → console ``` What changes is everything around it. The tutorial rebuilds the same system again and again while asking three questions, in this order: > **Who knows whom?** > > **Who owns what?** > > **Who decides how the system is wired together?** One summary is added here each time a step is finished, so the book grows at the pace of the work. Each summary says what the step did, what was observed when it ran, and what moved architecturally — usually a piece of knowledge that changed hands. ::: ::: {.fr} Ces notes résument le tutoriel **« SIN.04028 — From Calling to Eventing »**, parcouru étape par étape. Le tutoriel lui-même se trouve à côté de ce livre, dans `SIN.04028-From-Calling-to-Eventing/README.md`, et fait partie du cours *Process Control* donné par Reto Konig à l'Université de Fribourg (semestre d'automne 2026). Le programme construit ne change jamais : vous tapez une ligne, elle revient décalée de 13 lettres. ```text keyboard → ROT13 → console ``` Ce qui change, c'est tout ce qui l'entoure. Le tutoriel reconstruit le même système encore et encore en posant trois questions, dans cet ordre : > **Qui connaît qui ?** > > **Qui possède quoi ?** > > **Qui décide comment le système est câblé ?** Un résumé est ajouté ici chaque fois qu'une étape est terminée : le livre grandit donc au rythme du travail. Chaque résumé dit ce que l'étape a fait, ce qui a été observé à l'exécution, et ce qui a bougé sur le plan architectural — en général une connaissance qui a changé de mains. ::: ::: {.de} Diese Notizen fassen das Tutorial **„SIN.04028 — From Calling to Eventing“** zusammen, Schritt für Schritt durchgearbeitet. Das Tutorial selbst liegt neben diesem Buch, in `SIN.04028-From-Calling-to-Eventing/README.md`, und gehört zur Vorlesung *Process Control* von Reto Konig an der Universität Freiburg (Herbstsemester 2026). Das gebaute Programm ändert sich nie: Sie tippen eine Zeile, sie kommt um 13 Buchstaben verschoben zurück. ```text keyboard → ROT13 → console ``` Was sich ändert, ist alles ringsherum. Das Tutorial baut dasselbe System immer wieder neu und stellt dabei drei Fragen, in dieser Reihenfolge: > **Wer kennt wen?** > > **Wer besitzt was?** > > **Wer entscheidet, wie das System verdrahtet ist?** Jedes Mal, wenn ein Schritt fertig ist, kommt hier eine Zusammenfassung hinzu; das Buch wächst also im Tempo der Arbeit. Jede Zusammenfassung sagt, was der Schritt getan hat, was beim Ausführen beobachtet wurde und was sich architektonisch verschoben hat — meist ein Stück Wissen, das den Besitzer gewechselt hat. ::: ## [How to read the diagrams]{.en}[Comment lire les figures]{.fr}[Wie die Abbildungen zu lesen sind]{.de} {#sec-diagrams} ::: {.en} Every diagram exists once as a drawing and three times as a language. In the web version, a diagram that carries a message flow has a small play bar under it: **Play** walks one message through the whole chain, **One hop** advances a single step, and **Reset** puts it back. Boxes light up as the message reaches them, so you can see which component is waiting and which one is working. In the PDF, and in a browser with JavaScript switched off, the same picture is there — just still. Nothing in the notes depends on the animation. ::: ::: {.fr} Chaque figure existe une fois comme dessin et trois fois comme langue. Dans la version web, une figure qui porte un flux de messages possède une petite barre de lecture : **Lancer** fait parcourir toute la chaîne à un message, **Un saut** avance d'une seule étape, et **Réinitialiser** remet tout à zéro. Les boîtes s'allument au passage du message : on voit ainsi quel composant attend et lequel travaille. Dans le PDF, et dans un navigateur sans JavaScript, la même image est là — simplement immobile. Rien dans ces notes ne dépend de l'animation. ::: ::: {.de} Jede Abbildung existiert einmal als Zeichnung und dreimal als Sprache. In der Webfassung hat eine Abbildung mit Nachrichtenfluss eine kleine Leiste darunter: **Abspielen** schickt eine Nachricht durch die ganze Kette, **Ein Sprung** rückt einen einzigen Schritt vor, **Zurücksetzen** stellt alles zurück. Kästen leuchten auf, wenn die Nachricht sie erreicht; so ist zu sehen, welche Komponente wartet und welche arbeitet. Im PDF und in einem Browser ohne JavaScript ist dasselbe Bild da — nur unbewegt. Nichts in diesen Notizen hängt von der Animation ab. ::: ## [Building this book]{.en}[Construire ce livre]{.fr}[Dieses Buch bauen]{.de} {#sec-build} ::: {.en} The three books come from one source: ```bash ./render-all.sh # figures, then html + pdf for en, fr, de ./render-all.sh --serve # …and serve _book/ on http://localhost:8000 ``` `_book/` holds the English book, `_book/fr/` the French one and `_book/de/` the German one; the language menu in the sidebar switches between them and remembers the choice. A single `quarto render` builds English only and empties `_book/`, which removes the other two — so use the script. ::: ::: {.fr} Les trois livres proviennent d'une source unique : ```bash ./render-all.sh # figures, puis html + pdf pour en, fr, de ./render-all.sh --serve # …puis sert _book/ sur http://localhost:8000 ``` `_book/` contient le livre anglais, `_book/fr/` le français et `_book/de/` l'allemand ; le menu de langue dans la barre latérale passe de l'un à l'autre et retient le choix. Un simple `quarto render` ne construit que l'anglais et vide `_book/`, ce qui supprime les deux autres — utilisez donc le script. ::: ::: {.de} Die drei Bücher entstehen aus einer einzigen Quelle: ```bash ./render-all.sh # Abbildungen, dann html + pdf für en, fr, de ./render-all.sh --serve # …und _book/ auf http://localhost:8000 ausliefern ``` `_book/` enthält das englische Buch, `_book/fr/` das französische und `_book/de/` das deutsche; das Sprachmenü in der Seitenleiste wechselt zwischen ihnen und merkt sich die Wahl. Ein einfaches `quarto render` baut nur Englisch und leert `_book/`, was die anderen zwei entfernt — also das Skript benutzen. :::