Skip to content

Add comment-based help documentation to build.psm1 functions#27122

Merged
daxian-dbw merged 4 commits intoPowerShell:masterfrom
powercode:build_docs
Mar 31, 2026
Merged

Add comment-based help documentation to build.psm1 functions#27122
daxian-dbw merged 4 commits intoPowerShell:masterfrom
powercode:build_docs

Conversation

@powercode
Copy link
Copy Markdown
Collaborator

@powercode powercode commented Mar 31, 2026

Add comprehensive CBH (.SYNOPSIS, .DESCRIPTION, .PARAMETER, .OUTPUTS) to all module-level functions in build.psm1 that were previously undocumented. This covers ~60 functions including build, test, restore, bootstrap, NuGet, CI/pipeline, and utility functions.

PR Summary

PR Context

PR Checklist

Add comprehensive CBH (.SYNOPSIS, .DESCRIPTION, .PARAMETER, .OUTPUTS)
to all module-level functions in build.psm1 that were previously
undocumented. This covers ~60 functions including build, test, restore,
bootstrap, NuGet, CI/pipeline, and utility functions.
@powercode powercode requested a review from jshigetomi as a code owner March 31, 2026 11:15
Copilot AI review requested due to automatic review settings March 31, 2026 11:15
@powercode powercode requested a review from a team as a code owner March 31, 2026 11:15
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds comment-based help (CBH) to build.psm1 module functions so build/test/bootstrap/CI utilities surface discoverable help via Get-Help, improving maintainability and usability of the build tooling.

Changes:

  • Added CBH blocks (.SYNOPSIS, .DESCRIPTION, .PARAMETER, .OUTPUTS) across many existing functions in build.psm1.
  • Replaced an old inline comment block in ConvertFrom-PesterLog with proper CBH.
  • Minor whitespace/formatting touch-ups adjacent to the new help blocks.

Comment thread build.psm1
Comment thread build.psm1
Comment thread build.psm1 Outdated
Copy link
Copy Markdown
Member

@daxian-dbw daxian-dbw left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM. Thanks @powercode!

@daxian-dbw daxian-dbw added the CL-BuildPackaging Indicates that a PR should be marked as a build or packaging change in the Change Log label Mar 31, 2026
@daxian-dbw daxian-dbw merged commit 1216cb7 into PowerShell:master Mar 31, 2026
41 of 43 checks passed
@powercode powercode deleted the build_docs branch March 31, 2026 18:59
daxian-dbw pushed a commit to daxian-dbw/PowerShell that referenced this pull request Apr 9, 2026
daxian-dbw pushed a commit to daxian-dbw/PowerShell that referenced this pull request Apr 9, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Backport-7.4.x-Done Backport-7.5.x-Done Backport-7.6.x-Done CL-BuildPackaging Indicates that a PR should be marked as a build or packaging change in the Change Log

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants