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

Aperta
#159 3 commenti 0 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
4/5
Tempo stimato
3-5 giorni
Idoneità per principianti
45/100
Tipo di issue
Documentazione
Chiarezza
Specificata chiaramente
Stato di attività
Attiva
Stack tecnologico
powershell
Ambito
documentation, release

Direzione di ricerca

Esamina docs/migration-v0.8-to-v1.0.md dopo il merge delle gated pull requests, quindi esegui il relativo AI prompt all’inizio del file su un build.ps1 reale di un consumer. Conferma che la guida copra le modifiche comportamentali incompatibili e rilevanti per l’aggiornamento, verifica che il prompt non produca una build non funzionante e scrivi la voce 1.0.0 in CHANGELOG.md collegandola alla guida.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

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.

Lingua principale
PowerShell
Stelle
145
Fork
27
Merge medio
10h 16m
PR unite (30g)
34

Guida per i contributori

Apri la guida per i contributori

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di psake/PowerShellBuild

Tutte le issue di psake/PowerShellBuild

Issue simili

Altre issue su Documentation

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.