Added course's notes

This commit is contained in:
MatsuneMikuroi committed 2026-09-25 13:33:30 +02:00
1 parent e07993262c
commit dcd2c072ae
191 files changed
+42866 -12

No files matched your search

+137
View File
@@ -0,0 +1,137 @@
# [About these notes]{.en}[À propos de ces notes]{.fr}[Über diese Notizen]{.de} {#sec-about .unnumbered}
<!--
MULTILINGUAL (see _extensions/notes/i18n.lua):
- prose: ::: {.en} / {.fr} / {.de}
- headings, captions: [..]{.en}[..]{.fr}[..]{.de}
- short strings inside attributes, raw HTML, file paths: @tr{key} (i18n.yml)
- figures: one drawing in figures/src/, labels in figures/labels.yml, built
per language by figures/build-figures.py; a chapter refers to it without an
extension so html takes the svg and pdf the pdf.
- a figure with the class .flow-figure is animated in the html output by
figures/flow-player.html; the pdf and the no-JavaScript case show the same
picture, just still.
- fixed section ids (#sec-...) so anchors are identical in all three books.
English is the verified source: the tutorial being summarised is written in
English. French and German are translations of it.
Code identifiers, mailbox and topic names, file names, commands and protocol
terms are never translated (consoleIn.outbox, rot13/inbox, WatchService,
Mediator.java, .msg, put/take, Intent/Status/Event).
-->
::: {.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.
:::