📖 [Docs]: Remove Ways of Working (now maintained in MSXOrg/docs)#59
Merged
Marius Storhaug (MariusStorhaug) merged 1 commit intoJul 9, 2026
Merged
Conversation
The Ways of Working section moved to the organization-wide docs site (MSXOrg/docs), which is now the authoritative, generalized, and expanded source. Removing the near-verbatim copies here avoids drift. Kept framework-specific content (PowerShell modules/scripts/DSC/function apps, Solutions) and the more detailed coding standards, which are not yet mirrored in MSXOrg.
Contributor
Super-linter summary
All files and directories linted successfully For more information, see the GitHub Actions workflow run Powered by Super-linter |
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
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.
The Ways of Working documentation now lives in the organization-wide docs site, MSXOrg/docs, which is the authoritative, generalized, and expanded source. This removes the duplicated copies from the PSModule docs site so there is a single source of truth. As the org site states: "PSModule inherits the Coding Standards and Ways of Working from this site and adds only what is specific to the framework."
Removed: Ways of Working section
The Ways of Working navigation section and its 14 pages are removed from the PSModule docs site. Readers now find this material — generalized across the organization and expanded with additional pages — on the MSX docs site:
Every removed page (Workflow, Principles, Goal-Setting, Issue Format, Issue Hierarchy, PR Format, Commit Conventions, Review Etiquette, README-Driven Context, Git Worktrees, Continuous Practices, Development/Engineering Practices, DevOps Reference, and the section index) has an equivalent-or-superset counterpart on the MSX site, so no content is lost.
Changed: cross-links now point to the org site
Links that previously referenced these local pages now point to the MSX docs site:
Technical Details
src/docs/Ways-of-Working/(14 files, −1985 lines).Ways of Workingblock from thenavarray insrc/zensical.toml; the file still parses as valid TOML and every remaining nav target resolves on disk.src/docs/index.md,src/docs/Solutions/Infusing-GitHub-with-PowerShell.md, andsrc/docs/PowerShell/Standard/index.mdto the published MSX URLs; each target was verified to return HTTP 200.PowerShell/Standard, GitHub Actions Standards) and the Dictionary are intentionally kept — the PSModule versions are substantially more detailed (~2000 lines vs ~800 on MSX), so removing them would lose content rather than de-duplicate. If MSX should become authoritative for those as well, that is a good follow-up once the detail is mirrored there.