diff --git a/AGENTS.md b/AGENTS.md index 9dcb35a..c98b15b 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -8,6 +8,7 @@ Der abgenommene MVP liegt auf dem Branch `main`. Der [Produktvertrag](Rust_RMM_I 2. In der [Übergabe](docs/handover.md) den betroffenen Einstiegspunkt finden. Vor Änderungen den tatsächlichen Aufrufer, die Berechtigungsprüfung und die vorhandenen Tests lesen. Ein datierter Beleg in `docs/evidence/` dokumentiert das Ereignis zu seinem Messzeitpunkt. 3. Den normalen Bedienweg und den konkreten Fehlerfall prüfen. Bei einem Linux- oder Windows-spezifischen Verhalten den betreffenden Gast verwenden. Ein Build belegt die Erzeugung des Artefakts. Das Ergebnis des Zielgeräts belegt seine Wirkung. 4. Verändert sich das Produktverhalten, die zuständige Anleitung und den Produktvertrag abgleichen. Eine neue Abnahme im [Prüfstand](docs/mvp-completion-plan.md) mit Quelle, Ziel und beobachtetem Ergebnis nachtragen. +5. Nach jeder abgeschlossenen Änderung die zugehörigen Dateien committen und auf den passenden Branch in Gitea pushen. Das gilt auch für reine Dokuänderungen. Den gepushten Commit in Gitea prüfen. [Entwicklungsablauf](docs/development.md#änderungen-in-gitea-sichern) ## Regeln für Änderungen diff --git a/docs/development.md b/docs/development.md index f7bad0d..9f2ee12 100644 --- a/docs/development.md +++ b/docs/development.md @@ -1,5 +1,11 @@ # Entwickeln, bauen und ausliefern +## Änderungen in Gitea sichern + +Nach jeder abgeschlossenen Änderung die geprüften Dateien committen und den Commit auf den zugehörigen Gitea-Branch pushen. Das gilt für Code, Konfiguration und Dokumentation. Bei einem neuen Arbeitsbranch `git push -u origin HEAD` verwenden. Danach prüfen, dass der Commit auf dem Zielbranch in Gitea liegt. + +## Quellen bauen + Der Buildrunner verpackt die Quellen eines eingecheckten Git-Stands und baut mit den gepinnten Docker-Buildern. Die folgenden Befehle laufen vom Wurzelverzeichnis des Repositorys. `REVISION` durch den zu liefernden Commit ersetzen. Vor dem ersten Frontendbuild `npm --prefix web ci` ausführen. Für den Rust-Build werden Python 3, Git, Docker, tar, rsync und die zum Ziel passenden lokalen Builder-Images benötigt. [Buildrunner](../tools/build.py) | Ziel | Befehl | Ergebnis |