Skip to content

馃摉 [Docs]: Process-PSModule reference uses its canonical site - #158

Merged
Marius Storhaug (MariusStorhaug) merged 2 commits into
mainfrom
retire-process-reference
Aug 9, 2026
Merged

馃摉 [Docs]: Process-PSModule reference uses its canonical site#158
Marius Storhaug (MariusStorhaug) merged 2 commits into
mainfrom
retire-process-reference

Conversation

@MariusStorhaug

@MariusStorhaug Marius Storhaug (MariusStorhaug) commented Aug 9, 2026

Copy link
Copy Markdown
Member

Process-PSModule guidance will use the canonical PSModule documentation site, giving readers one authoritative reference once that site is publicly available.

Changed: Process-PSModule documentation reference

The MSX documentation navigation no longer publishes a separate local Process-PSModule reference. Every remaining documentation reference points to the canonical Process-PSModule documentation URL.


Technical details
  • Removes src/docs/Capabilities/process-psmodule/, including its media assets, and removes its Zensical navigation block.
  • This pull request remains a draft and must merge only after PSModule/Process-PSModule#447 merges, its target Pages deployment serves https://psmodule.io/docs/Modules/Process-PSModule/, and the canonical links have been verified.
  • Regenerates the Capabilities index and updates the PSModule initiative, PowerShell on GitHub design, and PowerShell testing references to the canonical URL.
  • Standards alignment: documentation content and Zensical navigation are aligned with the Documentation Model; no MSX-wide standards are changed.
Relevant issues (or links)

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@MariusStorhaug
Marius Storhaug (MariusStorhaug) marked this pull request as ready for review August 9, 2026 09:15
@MariusStorhaug
Marius Storhaug (MariusStorhaug) merged commit f5aa5d1 into main Aug 9, 2026
20 checks passed
@MariusStorhaug
Marius Storhaug (MariusStorhaug) deleted the retire-process-reference branch August 9, 2026 09:16
Marius Storhaug (MariusStorhaug) added a commit that referenced this pull request Aug 9, 2026
markdownlint's MD051 recognises a custom heading anchor only when the
braces contain no surrounding whitespace. With the spaced form the
heading keeps its slugified anchor, so same-page references such as
[FR1](#fr1) -- the form Spec-Driven-Development.md tells authors to
use -- are reported as broken link fragments, and a spec written by
following that page fails the linter the ecosystem runs in CI.

Convert all 20 occurrences: 6 in Spec-Driven-Development.md, covering
the prose that introduces the form and the specification template, and
14 in deployment/spec.md. Both forms render identically under
Python-Markdown's attr_list, which this site enables, so the published
output is unchanged. Test-DocumentationLink.ps1 matches the id with
\s* around the brace contents, so it resolves either form.

The 11 anchors this commit originally converted in
process-psmodule/spec.md are gone: #158 retired that capability's pages
in favour of its canonical site, and the file no longer exists.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Docs NoRelease No release required

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant