Commit a5d55eb
authored
π [Docs]: Remove Ways of Working (now maintained in MSXOrg/docs) (#59)
The Ways of Working documentation now lives in the organization-wide
docs site,
[MSXOrg/docs](https://msxorg.github.io/docs/Ways-of-Working/), 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:
- [Ways of Working on
MSXOrg/docs](https://msxorg.github.io/docs/Ways-of-Working/)
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.1 parent 5e217a1 commit a5d55eb
18 files changed
Lines changed: 4 additions & 1985 deletions
File tree
- src
- docs
- PowerShell/Standard
- Solutions
- Ways-of-Working
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
1 | 1 | | |
2 | 2 | | |
3 | 3 | | |
4 | | - | |
| 4 | + | |
5 | 5 | | |
6 | 6 | | |
7 | 7 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
1 | 1 | | |
2 | 2 | | |
3 | | - | |
| 3 | + | |
4 | 4 | | |
5 | 5 | | |
6 | 6 | | |
| |||
108 | 108 | | |
109 | 109 | | |
110 | 110 | | |
111 | | - | |
| 111 | + | |
This file was deleted.
This file was deleted.
This file was deleted.
0 commit comments