psake / psake/PowerShellBuild

Release: bump to 1.0.0 and publish to PSGallery

Ouverte
#160 0 commentaires 0 réactions 0 personnes assignées Voir sur GitHub

Personne n'a encore pris cette issue.

wayfinder:task
Langage dominant
PowerShell
Étoiles
145
Forks
27
Merge moyen
10 h 16 min
PR mergées (30 j)
34

Description

Part of #120 (Phase 5 — Release). This is the destination.

Scope

  • Bump ModuleVersion to 1.0.0 in PowerShellBuild.psd1
  • In the same commit, point the PSData URLs (LicenseUri, IconUri, ReleaseNotes) at /main/ rather than /master/. There is no master branch; those links resolve today only through GitHub's branch-rename redirect.
  • Cut the 1.0.0 GitHub Release. Publishing it triggers .github/workflows/publish.yaml, which runs the full test suite and then Publish-Module with the PSGALLERY_API_KEY repository secret — the path that published 0.8.0, 0.8.1 and 0.8.2.

Cut 1.0.0-rc1 and soak ≥ 7 daysdropped 2026-09-04. The install-time risk the rc existed for is covered two other ways: Publish-Module itself refuses to publish a package whose RequiredModules cannot be resolved on the destination repository, so an unsatisfiable dependency fails the release rather than reaching consumers; and #229 installs the built module from a local repository in CI on both editions. What the rc uniquely offered was consumer exposure, which prerelease build tooling does not get in practice. Recorded on #120.

Pre-flight before tagging

  • #159 closed — the guide's coherence pass and the 1.0.0 changelog entry
  • #229 green on main
  • A workflow_dispatch run of publish.yaml against main has completed — done 2026-09-04, run 33914510553: checkout@v7, bootstrap, and the psake chain Init Clean Build Analyze Pester all ran on the ubuntu runner (558 passed, 0 failed, 33 Windows-only skips), and the only failure was Publish-Module refusing 0.8.2 as already published on the gallery. The manual-trigger recovery path is therefore proven too. It exercises checkout v7 (first use since #214), bootstrap and the full suite on the runner, and is expected to fail only at Publish-Module because 0.8.2 already exists on the gallery — the whole workflow proven except the upload, at zero risk. The manual trigger failed the one time it was used and its logs have expired, so this also verifies the recovery path in advance.

Gate

Blocked on the release documentation being final. Everything else in the map must be closed or explicitly ruled out of scope before this opens.

Definition of done (from #120)

  • Every in-scope item is closed
  • The Phase 4 milestone discrepancy is resolved — #94 and #95 unmilestoned during charting and since closed. #98 and #103 were restored to v1.0.0 on 2026-08-28 and now block this issue: they are the only two public functions without coverage of their own, and the compile-mode test that appeared to cover Build-PSBuildModule asserts on file text only, so it passes over a module that exports nothing (#201)
  • Every public function has coverage of its own, and #201 is resolved
  • The migration guide is complete and the AI prompt is tested against a sample consumer build.ps1
  • 1.0.0-rc1 has soaked ≥ 7 days with no blocker reports

Done when

PowerShellBuild 1.0.0 is on PSGallery. The map is complete.

Guide de contribution

Ouvrir le guide de contribution

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Piste de recherche

Commencez par PowerShellBuild.psd1 et .github/workflows/publish.yaml, puis vérifiez les dépendances de pré-exécution #159, #229, #98, #103 et #201 avant de modifier les métadonnées de la release. Confirmez que les contrôles de documentation et de couverture sont terminés, puis créez la GitHub Release 1.0.0 afin que le workflow publie le module dans PSGallery. La tâche est terminée lorsque PowerShellBuild 1.0.0 est disponible dans PSGallery et que la correspondance des releases est complète.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Évaluation

Stack technique
github-actions, powershell
Domaine
ci-cd, release
Type d'issue
Fonctionnalité
Difficulté
5/5
Temps estimé
Plus d'une semaine
Activité
Calme
Clarté
Plutôt claire
Accessibilité débutants
35/100

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.