Auftrennung in zwei getrennte Bewerbungen als Admin oder Senior Dev

07_bewerbung-typst/README.md

@@ -4,9 +4,16 @@ Dieser Ordner ist unabhängig von den LaTeX-Quellen im übergeordneten Projekt.
 Er enthält die Typst-Dokumente, die gemeinsame Vorlage, alle benötigten Schriften
 und die Unterschrift.
 
+Die beiden unabhängig bearbeitbaren Varianten liegen in `Admin/` und
+`Senior Developer/`. Jedes Verzeichnis enthält ein Anschreiben und einen
+Lebenslauf als `.typ` sowie die daraus erzeugten PDFs. Beide Varianten wurden
+zunächst mit den bestehenden Entwicklertexten angelegt; die Admin-Texte können
+anschließend angepasst werden.
+
 ## Voraussetzungen
 
 - Typst 0.15 oder neuer
+- Python 3 (für die gebündelte Ausgabe im Watch-Modus)
 - `make` (optional; die Typst-Befehle können auch direkt ausgeführt werden)
 
 ## PDFs bauen
@@ -17,16 +24,18 @@ Im Ordner `07_bewerbung-typst`:
 make all
 ```
 
-Die Ergebnisse liegen unter `build/` und tragen den Namen der jeweiligen
-Typst-Quelldatei mit der Endung `.pdf`.
+Die vier Ergebnisse liegen direkt neben ihren Typst-Quelldateien in `Admin/`
+und `Senior Developer/` und tragen denselben Namen mit der Endung `.pdf`.
+Die PDFs werden von Git ignoriert.
 
-Einzeln lassen sich die Dokumente mit `make coverletter` und `make cv` bauen.
+`make all` baut fehlende oder veraltete PDFs. Auch `make` ohne Argumente führt
+dieses Ziel aus. `make clean` entfernt die vier erzeugten PDFs.
 
 ## Dateien umbenennen
 
-Die aktuellen Quelldateien stehen ausschließlich in den Variablen
+Die gemeinsamen Quelldateinamen stehen ausschließlich in den Variablen
 `COVERLETTER_SRC` und `CV_SRC` am Anfang des `Makefile`.
-Nach einer Umbenennung diese beiden Angaben entsprechend anpassen.
+Nach einer Umbenennung in beiden Rollenverzeichnissen diese Angaben entsprechend anpassen.
 Build, Watch-Modus und PDF-Namen verwenden automatisch diese Konfiguration.
 Einen laufenden Watch-Modus nach Änderungen am Makefile neu starten.
 
@@ -40,15 +49,24 @@ make -nB all
 
 ## Automatisch bei Änderungen bauen
 
-Der Watch-Modus überwacht beide Dokumente einschließlich ihrer importierten
-Vorlagen und erzeugt die PDFs nach jeder gespeicherten Änderung neu:
+Der Watch-Modus baut beim Start alle vier Dokumente und überwacht anschließend
+ihre Quellen einschließlich der importierten Vorlagen. Bei Änderungen werden
+nur die betroffenen PDFs neu erzeugt; Änderungen an `personal.typ` oder
+`template.typ` betreffen alle vier Dokumente:
 
 ```sh
 make watch
 ```
 
-Die Überwachung läuft, bis sie mit `Ctrl+C` beendet wird. Einzelne Dokumente
-lassen sich mit `make watch-coverletter` oder `make watch-cv` überwachen.
+Die Überwachung läuft, bis sie mit `Ctrl+C` beendet wird. Dabei werden alle
+vier Watch-Prozesse beendet. Die drei Befehle sind `make all`, `make clean`
+und `make watch`.
+`watch.py` bündelt die Ausgabe zeilenweise und stellt jeder Meldung den
+Dokumentpfad voran, damit gleichzeitige Status- und Fehlermeldungen lesbar bleiben.
 
 Gemeinsame Kontaktdaten werden in `personal.typ` gepflegt. Farben, Kopf- und
 Fußzeilen sowie wiederverwendbare CV-Komponenten stehen in `template.typ`.
+Diese Dateien sowie `fonts/` und `assets/` werden von beiden Varianten gemeinsam
+verwendet. Das Makefile setzt `--root .`, damit Typst aus den Unterverzeichnissen
+auf diese Ressourcen zugreifen kann.
+`personal.typ` und `template.typ` müssen deshalb im Typst-Hauptverzeichnis bleiben.