Add comprehensive PowerShellBuild documentation section#42
Merged
HeyItsGilbert merged 4 commits intomainfrom Feb 22, 2026
Merged
Add comprehensive PowerShellBuild documentation section#42HeyItsGilbert merged 4 commits intomainfrom
HeyItsGilbert merged 4 commits intomainfrom
Conversation
Documents the proposed structure for adding PowerShellBuild coverage to the psake docs site, including five new pages and sidebar changes. https://claude.ai/code/session_01TU1s3wRx7eGZhMJJXvY5Kz
Creates five new pages under docs/powershellbuild/: - introduction.md — What PowerShellBuild is and how it relates to psake - getting-started.md — Step-by-step setup guide with minimal psakeFile.ps1 - task-reference.md — All tasks with dependency graph (Mermaid) and descriptions - configuration.md — Full $PSBPreference and dependency variable reference - real-world-example.md — Complete project with CI/CD and PSGallery publishing Also adds the PowerShellBuild category to guidesSidebar in sidebars.ts, positioned between Advanced Techniques and Build Type Examples. https://claude.ai/code/session_01TU1s3wRx7eGZhMJJXvY5Kz
✅ Deploy Preview for psake ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
Moves PowerShellBuild out of the Guides sidebar into a dedicated powershellBuildSidebar so it appears as a peer of Get Started, Guides, and Reference in the navbar. Also adds a footer link under Docs. https://claude.ai/code/session_01TU1s3wRx7eGZhMJJXvY5Kz
…ngs.psd1 The default SettingsPath is not $null — PowerShellBuild automatically looks for PSScriptAnalyzerSettings.psd1 in the project root. Updated the configuration reference default value and description, the real-world example to rely on the convention instead of an explicit override, and the example filename from .psscriptanalyzer.psd1 to PSScriptAnalyzerSettings.psd1. https://claude.ai/code/session_01TU1s3wRx7eGZhMJJXvY5Kz
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
This PR adds a complete documentation section for PowerShellBuild, the official companion module to psake that provides pre-built tasks for PowerShell module projects. The new section includes five focused guides covering introduction, getting started, task reference, configuration, and a real-world example.
Key Changes
New documentation category: Created
docs/powershellbuild/with five comprehensive markdown files:introduction.md— Overview of PowerShellBuild, its relationship to psake, and when to use itgetting-started.md— Step-by-step guide to set up PowerShellBuild in a new project with minimal configurationtask-reference.md— Complete reference of all pre-built tasks with dependency graph (Mermaid diagram) and descriptionsconfiguration.md— Full$PSBPreferencehashtable reference with all configuration options organized by categoryreal-world-example.md— Production-ready example project showing custom tasks, CI/CD integration, and PSGallery publishingSidebar integration: Updated
sidebars.tsto add the new PowerShellBuild category to the guides sidebar (positioned between "Advanced Techniques" and "Build Type Examples")Category metadata: Added
_category_.jsonfor Docusaurus sidebar auto-generationNotable Implementation Details
https://claude.ai/code/session_01TU1s3wRx7eGZhMJJXvY5Kz