feat(docs): Changelog mit "was ist seit meiner Fassung neu"
Bisher musste ein Agent, der eine Anbindung aktualisiert, die gesamte Historie lesen - oder er las gar nichts und uebersah eine brechende Aenderung. Beides schlecht. - public/docs/changelog.json ist die einzige Quelle. Je Fassung eine Zusammenfassung, je Aenderung Bereich, ein "breaking"-Kennzeichen und vor allem ein Feld "action" mit dem, was konkret zu tun ist. Steht dort null, ist nichts zu tun - das ist die haeufigste und nuetzlichste Antwort. - GET /api/updateservice/v1/changelog?since=2.2.0 liefert nur die neueren Fassungen, dazu die Anzahl der Punkte mit Handlungsbedarf und der brechenden Aenderungen. count:0 heisst "du bist auf Stand" - dann muss gar nichts gelesen werden. Optional nach Bereich filterbar (?area=packager). - /docs/changelog.php rendert dieselbe Datei fuer Menschen, mit Eingabefeld fuer die eigene Fassung. Bewusst dieselbe Quelle: zwei Fassungen zu pflegen hiesse, sie auseinanderlaufen zu lassen. - DeploymentcenterSdk.Version im SDK ist der Bezugspunkt. Damit muss die Fassung nicht abgetippt werden. - AGENT_PROMPT_TEMPLATE.md verpflichtet dazu, sie in der AGENTS.md des Projekts festzuhalten und vor jeder Aenderung an der Anbindung den Unterschied abzufragen. Auch in der Kurzfassung fuer knappe Prompt-Budgets. Die Historie ist rueckwirkend bis 2.0.0 gefuellt: 6 Fassungen, 25 Punkte mit Handlungsbedarf, 13 brechende Aenderungen. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
co-authored by
Claude Opus 5
parent
1967b49ad7
commit
a8b9f6f7c9
@@ -4,6 +4,19 @@
|
||||
> Ergebnis: `./scripts/release.ps1 -Version 1.4.3` baut, packt, lädt hoch und
|
||||
> meldet das Release beim Deploymentcenter an — für alle Zielplattformen.
|
||||
|
||||
> **Aktualisierst du eine bestehende Anbindung?** Dann lies nicht alles neu.
|
||||
> Frag zuerst, was seit deiner Fassung dazugekommen ist:
|
||||
>
|
||||
> ```
|
||||
> GET /api/updateservice/v1/changelog?since=2.2.0
|
||||
> ```
|
||||
>
|
||||
> `count: 0` heißt: du bist auf Stand. Sonst nennt jeder Eintrag unter
|
||||
> `action`, was konkret zu tun ist. Für Menschen: [/docs/changelog.php](./changelog.php).
|
||||
> Die eigene Fassung steht in `DeploymentcenterSdk.Version` — **und gehört in
|
||||
> die `AGENTS.md` deines Projekts**, sonst fängst du beim nächsten Mal wieder
|
||||
> von vorn an.
|
||||
|
||||
Es gibt bereits ein Werkzeug, das den schwierigen Teil erledigt:
|
||||
**`pack-and-deploy`**. Es berechnet Prüfsummen, erzeugt das Dateimanifest,
|
||||
schreibt die `latest.json` fort und meldet das Release über die API an. **Baue
|
||||
|
||||
Reference in New Issue
Block a user