📖 [Docs]: Module-local workflow phases documented as root-only

[Marius Storhaug (MariusStorhaug)]

Module authors can now distinguish the two root-only workflow phase scripts from recursively discovered module-local test entries.

Fixed: Setup and teardown discovery is unambiguous

tests/BeforeAll.ps1 and tests/AfterAll.ps1 are documented as exact, non-recursive paths that run once around the module-local test matrix. Ordinary Advanced test entries remain separately eligible for recursive discovery under tests/.

---

Technical details

• Corrects src/docs/Frameworks/Process-PSModule/pipeline-stages.md to match the exact Test-Path checks in Process-PSModule main.
• Separates workflow phase detection from recursive configuration, container, and test-file discovery.
• Implementation plan progress: all tasks in Clarify module-local setup and teardown discovery #99 are complete.
• Validation passed: documentation indexes, links, Zensical build, Super-Linter, and diff checks.
• Copilot review converged after the clarity feedback was addressed; the final round added no comments.

Relevant issues (or links)

• Fixes Clarify module-local setup and teardown discovery #99
• 📖 [Docs]: Module test layouts aligned with Process-PSModule PSModule/docs#88

[Copilot]

Pull request overview

Updates the Process-PSModule pipeline documentation to clearly distinguish root-only workflow phase scripts (tests/BeforeAll.ps1 / tests/AfterAll.ps1) from recursively discovered module-local tests under tests/, aligning the docs with the current workflow detection behavior.

Changes:

• Documented tests/BeforeAll.ps1 and tests/AfterAll.ps1 as exact, repository-root-only (non-recursive) workflow phase paths.
• Clarified that nested BeforeAll.ps1 / AfterAll.ps1 files under tests/ do not create workflow phases.

[Copilot]

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated no new comments.