Skip to content

docs: explain shared task modules - #67

Merged
HeyItsGilbert merged 4 commits into
mainfrom
docs/18-shared-task-modules
Aug 31, 2026
Merged

docs: explain shared task modules#67
HeyItsGilbert merged 4 commits into
mainfrom
docs/18-shared-task-modules

Conversation

@HeyItsGilbert

Copy link
Copy Markdown
Member

Summary

  • add an end-to-end guide for authoring, discovering, consuming, and testing shared psake task modules
  • document task loading, naming, version selection, overrides, and production safety constraints
  • add guide navigation and cross-links
  • correct stale PowerShellBuild versions and clarify that -FromModule discovers and dot-sources task definitions rather than importing the module

Verification

  • smoke-tested inline and function-based providers with psake 5.0.5
  • passed the documented Pester integration test with Pester 5.6.1
  • bun run build

Closes #18

Copilot AI lite review requested due to automatic review settings August 30, 2026 23:59
@netlify

netlify Bot commented Aug 30, 2026

Copy link
Copy Markdown

Deploy Preview for psake ready!

Name Link
🔨 Latest commit 737cbe7
🔍 Latest deploy log https://app.netlify.com/projects/psake/deploys/6a94c8e9c9b93500083e87f4
😎 Deploy Preview https://deploy-preview-67--psake.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Adds a new advanced-guide page explaining how to author and consume shared psake task modules (via Task -FromModule), and updates existing docs to cross-link to this guidance and reflect current PowerShellBuild/psake version expectations.

Changes:

  • Added an end-to-end tutorial for building, versioning, consuming, and integration-testing a shared task provider module.
  • Updated PowerShellBuild docs to reflect current version requirements and clarified -FromModule loading behavior (dot-sourcing provider psakeFile.ps1).
  • Added navigation and cross-links so readers can discover the new guide from related topics.

Reviewed changes

Copilot reviewed 7 out of 7 changed files in this pull request and generated 1 comment.

Show a summary per file
File Description
sidebars.ts Adds the new advanced tutorial page to the “Advanced Techniques” sidebar section.
docs/tutorial-advanced/creating-shared-task-modules.md New end-to-end guide for shared task modules, including versioning, overrides, and production constraints.
docs/tutorial-advanced/access-functions-in-another-file.md Adds a pointer from Include usage to the new shared-module guide.
docs/powershellbuild/introduction.md Updates version guidance and clarifies how -FromModule loads tasks (dot-sourcing provider psakeFile.ps1).
docs/powershellbuild/getting-started.md Updates prerequisite versions and clarifies -FromModule behavior; adds link to the new shared-module guide.
docs/best-practices/organizing-large-scripts.md Adds a “See Also” link to the new shared-module guide.
CONTEXT.md Introduces standardized terminology for shared task modules and related concepts.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread docs/tutorial-advanced/creating-shared-task-modules.md
@HeyItsGilbert
HeyItsGilbert merged commit 5f7e24d into main Aug 31, 2026
10 checks passed
@HeyItsGilbert
HeyItsGilbert deleted the docs/18-shared-task-modules branch August 31, 2026 02:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

New Doc: Creating Shared Modules

2 participants