📖 [Docs]: Documentation links in the community files resolve again

[Marius Storhaug (MariusStorhaug)]

Documentation links in this repository's community files now resolve. Two PSModule docs pages they pointed at have been renamed or moved, so a maintainer or agent following the guidance chain landed on a 404 instead of the page they were sent to.

Fixed: the repository standard link resolves

The "repository defaults" link now points at Repository standard, which is where that page lives after it was renamed in PSModule/docs#96. The link text follows the page's new name.

Fixed: the issue format link resolves

The "issue format" link pointed at Ways-of-Working/Issue-Format/, which no longer exists. It now points at Issues / Process / Format, the page that replaced it.

Changed: PSModule documentation links use the canonical host

PSModule documentation links now use psmodule.io directly instead of psmodule.github.io, which only reaches the site through a redirect. Readers end up in the same place; the links now simply state the canonical host.

---

Technical details

Why these files drifted. AGENTS.md, CONTRIBUTING.md, and README.md originate in PSModule/Template-PSModule and were copied here when this repository was created. When the destination page was renamed, the copies were not updated, and nothing checks them. The same correction is applied at the source in PSModule/Template-PSModule#42 so new repositories start correct; this pull request fixes the copy that already shipped. PSModule/docs#63 tracks distributing these files, which is the durable answer to this class of drift.

How it was found. PSModule/docs#106 established that the documentation site had not been republished since 2026-07-18, which is why the old URL still appeared to work — it was serving a stale build. Once PSModule/docs#107 restores publishing, the rename goes live and the old path starts returning 404. Referrers were enumerated with gh search code "Repository-Defaults" --owner PSModule; the full set is recorded on PSModule/docs#108.

Host handling. psmodule.github.io returns 301 to psmodule.io, and PSModule/docs declares site_url = "https://psmodule.io/docs/", so psmodule.io is canonical and the links now say so. The MSX links were deliberately left on msxorg.github.io: that host also redirects, to msx.no, but MSXOrg/docs still declares site_url = "https://msxorg.github.io/...", so which host is canonical there is unsettled and this pull request does not decide it. Only the genuinely broken MSX path was corrected.

Verification. Every documentation URL in the changed files was requested; all return 200, except https://psmodule.io/docs/Modules/Repository-Standard/, which returns 404 until PSModule/docs#107 restores publishing and 200 after. This pull request should therefore merge after that one.

Standards and framework alignment.

Changed surface	Standards checked	Framework docs checked	Result
AGENTS.md, CONTRIBUTING.md, README.md	Markdown, Documentation — link-only changes, structure untouched	Repository standard — the files remain present and unchanged in purpose	Aligned

Issue convergence sweep. Scope: open issues in this repository and in PSModule/docs concerning documentation links or the community files. Nothing in this repository is fully satisfied by this diff. PSModule/docs#108 is only partially satisfied — it also covers the template and the other propagated copies — so it is linked without a closing keyword.

Relevant issues (or links)

• Keep links to the renamed Repository Standard page resolving docs#108 — the link rot this pull request covers this repository's share of
• 📖 [Docs]: Documentation links in the template resolve again Template-PSModule#42 — the same fix at the source
• 🪲 [Fix]: Documentation site publishes again on every push and scheduled run docs#107 — restores publishing, and must merge first
• 📖 [Docs]: Module repository page becomes the Repository Standard aligned with MSX docs#96 — the rename

[github-actions]

No Significant Changes Detected

This PR does not contain changes to files that would trigger a new release:

Pattern	Description
^src/	Matches files where path matches this pattern
^README\.md$	Matches files where path matches this pattern

Build, test, and publish stages will be skipped for this PR.

If you believe this is incorrect, please verify that your changes are in the correct locations.

[github-actions]

Super-linter summary

Language	Validation result
CHECKOV	Pass ✅
GITHUB_ACTIONS	Pass ✅
GITLEAKS	Pass ✅
GIT_MERGE_CONFLICT_MARKERS	Pass ✅
MARKDOWN	Pass ✅
NATURAL_LANGUAGE	Pass ✅
POWERSHELL	Pass ✅
PRE_COMMIT	Pass ✅
SPELL_CODESPELL	Pass ✅
TRIVY	Pass ✅
YAML	Pass ✅

All files and directories linted successfully

For more information, see the GitHub Actions workflow run

Powered by Super-linter

[Copilot]

Pull request overview

This PR updates documentation URLs in this repository’s community guidance files so that referenced PSModule/MSXOrg documentation pages resolve again (reflecting moved/renamed pages and canonical hosts).

Changes:

• Update “Repository defaults” references to the renamed “Repository standard” page and adjust link text accordingly.
• Fix the MSXOrg “issue format” link to the new replacement path.
• Switch PSModule documentation links from psmodule.github.io to the canonical psmodule.io host.

Reviewed changes

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

File	Description
AGENTS.md	Updates PSModule guidance links to psmodule.io and renames “Repository defaults” → “Repository standard”.
CONTRIBUTING.md	Fixes “repository standard”, “issue format”, and PSModule Standards links so they resolve and use canonical hosts.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.