Added course's notes
This commit is contained in:
1 parent
e07993262c
commit
dcd2c072ae
191 files changed
+42866
-12
No files matched your search
@@ -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.
|
||||
:::
|
||||
Reference in new issue
Block a user