Files
MatsuneMikuroiandClaude Opus 5 f7fa60ba81 Night-mode styling, French cross-references, and the log through Part VI
- theme.scss and figures draw with the extension's --calc-… tokens; light/dark
  pair plus the high-contrast button; a11y highlight style for html
- figure labels split so none leaves its viewBox in any language
- _quarto-fr.yml: French cross-reference prefixes
- notes extension synced to 2.8.18
- conv/: Parts IV, V and VI logged, pasted terminal output redacted

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-10-06 03:36:51 +02:00

109 lines
5.9 KiB
Plaintext

# [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 material these notes are built from 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 follow one small program through a long series of rebuilds, from direct method calls to an event-driven architecture over MQTT. Every rebuild leaves the program doing exactly what it did before, and changes who knows about whom.
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 same system is rebuilt again and again, and each rebuild asks 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.
*Based on material by Reto Konig, University of Fribourg.*
:::
::: {.fr}
Ces notes suivent un petit programme à travers une longue série de reconstructions, de l'appel de méthode direct à une architecture événementielle sur MQTT. Chaque reconstruction laisse le programme faire exactement ce qu'il faisait avant, et change qui connaît qui.
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 même système est reconstruit encore et encore, et chaque reconstruction pose 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.
*D'après le matériel de Reto Konig, Université de Fribourg.*
:::
::: {.de}
Diese Notizen verfolgen ein kleines Programm durch eine lange Reihe von Neubauten, vom direkten Methodenaufruf bis zu einer ereignisgetriebenen Architektur über MQTT. Jeder Neubau lässt das Programm genau das tun, was es vorher tat, und ändert, wer von wem weiss.
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. Dasselbe System wird immer wieder neu gebaut, und jeder Neubau stellt 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.
*Nach Material von Reto Konig, Universität Freiburg.*
:::
## [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.
:::