Release: finalize the migration guide, test the AI prompt, write the 1.0.0 changelog

Offen
#159 3 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

Bewertung

Schwierigkeit
4/5
Geschätzter Aufwand
3-5 Tage
Anfängerfreundlichkeit
45/100
Issue-Typ
Dokumentation
Klarheit
Klar beschrieben
Aktivitätsstatus
Aktiv
Tech-Stack
powershell
Bereich
documentation, release

Rechercherichtung

Überprüfe docs/migration-v0.8-to-v1.0.md, nachdem die gated pull requests zusammengeführt wurden, führe dann den AI prompt am Anfang der Datei gegen einen echten Consumer-Build mit build.ps1 aus. Bestätige, dass der Leitfaden abwärtsinkompatible und für Upgrades relevante Verhaltensänderungen abdeckt, verifiziere, dass der Prompt keinen fehlerhaften Build erzeugt, und schreibe den 1.0.0-Eintrag in CHANGELOG.md mit einem Link zum Leitfaden.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

wayfinder:task

Part of #120 (Phase 5 — Release).

Scope

Finalize the consumer-facing release documentation, once the full break surface is known and soaking.

  • docs/migration-v0.8-to-v1.0.md — review end to end. Per-PR entries have been accumulating throughout the cycle by design, so this is a coherence and completeness pass, not a writeup from scratch. Confirm the scope decision holds: breaking changes plus behavioral changes that can require action on upgrade.
  • Test the AI migration prompt. The guide's top-of-file prompt is a v1.0.0 deliverable and has never been exercised. Run it against a real sample consumer build.ps1 with an agent and fix what it gets wrong. An untested prompt that produces a broken build.ps1 is worse than no prompt.
  • CHANGELOG.md — write the 1.0.0 entry, summarizing the breaks and linking to the migration guide.

Gate

Blocked on every other v1.0.0 pull request being merged — the break surface must be complete before the guide can be called finished. Re-gated 2026-09-04: the preview and rc were dropped from the plan, so the gate is now the merge of #224, #225, #226, #227 and #228. This issue must close before 1.0.0 is tagged.

Done when

The migration guide is complete, the AI prompt has been verified against a sample consumer build, and the changelog entry is written.

Vorherrschende Sprache
PowerShell
Sterne
145
Forks
27
Ø Merge
10 Std. 16 Min.
Gemergte PRs (30 T.)
34

Beitragsleitfaden

Beitragsleitfaden öffnen

Erste Schritte

  1. Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
  3. Forken Sie das Repository und arbeiten Sie in einem Branch.
  4. Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.

Mehr aus psake/PowerShellBuild

Alle Issues in psake/PowerShellBuild

Ähnliche Issues

Weitere Issues zu Documentation

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.