Skip to content

📖 [Docs]: Remove Ways of Working (now maintained in MSXOrg/docs)#59

Merged
Marius Storhaug (MariusStorhaug) merged 1 commit into
mainfrom
docs/remove-migrated-ways-of-working
Jul 9, 2026
Merged

📖 [Docs]: Remove Ways of Working (now maintained in MSXOrg/docs)#59
Marius Storhaug (MariusStorhaug) merged 1 commit into
mainfrom
docs/remove-migrated-ways-of-working

Conversation

@MariusStorhaug

Copy link
Copy Markdown
Member

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:

  • Home page "objectives and initiatives" → MSX Goal-Setting
  • "Infusing GitHub with PowerShell" mission and initiatives links → MSX Goal-Setting
  • PowerShell standards "Principles" reference → MSX Principles

Technical Details

  • Deleted src/docs/Ways-of-Working/ (14 files, −1985 lines).
  • Removed the Ways of Working block from the nav array in src/zensical.toml; the file still parses as valid TOML and every remaining nav target resolves on disk.
  • Repointed the 4 inbound links in src/docs/index.md, src/docs/Solutions/Infusing-GitHub-with-PowerShell.md, and src/docs/PowerShell/Standard/index.md to the published MSX URLs; each target was verified to return HTTP 200.
  • Scope note: This PR removes only the Ways of Working section, which was a near-verbatim move to MSXOrg. The coding-standards content (Style Guides, 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.

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.
@github-actions

github-actions Bot commented Jul 9, 2026

Copy link
Copy Markdown
Contributor

Super-linter summary

Language Validation result
CHECKOV Pass ✅
GITHUB_ACTIONS Pass ✅
GITHUB_ACTIONS_ZIZMOR Pass ✅
GITLEAKS Pass ✅
GIT_MERGE_CONFLICT_MARKERS Pass ✅
HTML Pass ✅
JAVASCRIPT_ES Pass ✅
JAVASCRIPT_PRETTIER 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

@MariusStorhaug Marius Storhaug (MariusStorhaug) merged commit a5d55eb into main Jul 9, 2026
21 checks passed
@MariusStorhaug Marius Storhaug (MariusStorhaug) deleted the docs/remove-migrated-ways-of-working branch July 9, 2026 03:38
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.

1 participant