Skip to content

Commit 02420bb

Browse files
docs: clarify documentation ownership
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
1 parent 771dde8 commit 02420bb

9 files changed

Lines changed: 16 additions & 32 deletions

File tree

docs/content/Modules/Process-PSModule/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
Process-PSModule is the module delivery framework used in PSModule repositories.
44

5-
This section documents how module repositories are formed and how they move from source to published artifact.
5+
This section documents module repository structure and the build and publication lifecycle.
66

77
## In this section
88

docs/content/Modules/Repository-Standard.md

Lines changed: 0 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -187,12 +187,6 @@ For PSModule module repositories, the requirements are:
187187
- Managed copies of those files are treated as generated distribution artifacts, not repository-specific source.
188188
- Standard changes to managed-file content are made in the distribution engine, not by patching generated copies in receiving repositories.
189189

190-
### Migration for existing repositories
191-
192-
Repositories still aligned to `PSModule/Distributor` (the previous distribution engine) should migrate to Custo as the runtime implementation.
193-
194-
This page defines the required target state (the file requirements). Runtime migration mechanics and rollout design (repository targeting, update flow, overwrite behavior, and deletion behavior) are owned by Custo and should be documented and executed from the Custo repository.
195-
196190
## Supply-chain defaults
197191

198192
Every module repository must include `.github/dependabot.yml`. Dependabot is part of the repository supply-chain control, not an optional convenience.
Lines changed: 2 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,8 @@
1-
# PowerShell DSC (Moved)
1+
# PowerShell DSC
22

3-
Cross-org infrastructure and PowerShell guidance is now canonical in MSXOrg/docs.
3+
Cross-org infrastructure and PowerShell guidance is maintained in MSXOrg/docs.
44

55
Use:
66

77
- [MSX Coding Standards](https://msxorg.github.io/docs/Coding-Standards/)
88
- [MSX Capabilities](https://msxorg.github.io/docs/Capabilities/)
9-
10-
This page is retained as a migration pointer only.
Lines changed: 2 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,8 @@
1-
# PowerShell Function Apps (Moved)
1+
# PowerShell Function Apps
22

3-
Cross-org Function App guidance is now canonical in MSXOrg/docs.
3+
Cross-org Function App guidance is maintained in MSXOrg/docs.
44

55
Use:
66

77
- [MSX Capabilities](https://msxorg.github.io/docs/Capabilities/)
88
- [MSX Coding Standards](https://msxorg.github.io/docs/Coding-Standards/)
9-
10-
This page is retained as a migration pointer only.
Lines changed: 2 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,7 @@
1-
# PowerShell Scripts (Moved)
1+
# PowerShell Scripts
22

3-
Cross-org PowerShell script standards are now canonical in MSXOrg/docs.
3+
Cross-org PowerShell script standards are maintained in MSXOrg/docs.
44

55
Use:
66

77
- [MSX Coding Standards / PowerShell / Scripts](https://msxorg.github.io/docs/Coding-Standards/PowerShell/Scripts/)
8-
9-
This page is retained as a migration pointer only.

docs/content/PowerShell/Standard/index.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
1-
# PowerShell Standards (Moved)
1+
# PowerShell Standards
22

3-
Cross-org PowerShell standards are now canonical in MSXOrg/docs.
3+
Cross-org PowerShell standards are maintained in MSXOrg/docs.
44

55
Use:
66

docs/content/Solutions/index.md

Lines changed: 2 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,8 @@
1-
# Solutions (Moved)
1+
# Solutions
22

3-
Reusable solution architecture and system patterns are now canonical in MSXOrg/docs.
3+
Reusable solution architecture and system patterns are maintained in MSXOrg/docs.
44

55
Use:
66

77
- [MSX Capabilities](https://msxorg.github.io/docs/Capabilities/)
88
- [MSX Initiatives](https://msxorg.github.io/docs/Initiatives/)
9-
10-
This page is retained as a migration pointer only.

docs/content/Style-Guides/index.md

Lines changed: 2 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -3,12 +3,10 @@ title: Style Guides
33
description: Coding style guidelines for PSModule repositories.
44
---
55

6-
# Style Guides (Moved)
6+
# Style Guides
77

8-
Style guide content is now canonical in MSXOrg/docs.
8+
Style guide content is maintained in MSXOrg/docs.
99

1010
Use:
1111

1212
- [MSX Coding Standards](https://msxorg.github.io/docs/Coding-Standards/)
13-
14-
This page is retained as a migration pointer only.

docs/content/index.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -33,15 +33,15 @@ We empower PowerShell-savvy developers to effortlessly transform their ideas int
3333

3434
Where we are headed is tracked as [objectives and initiatives](https://msxorg.github.io/docs/Ways-of-Working/Goal-Setting/).
3535

36-
## What this docs site now owns
36+
## PSModule documentation
3737

38-
This site is now focused on PSModule-org specific documentation:
38+
This site covers PSModule organization-specific documentation:
3939

4040
- [Modules](Modules/index.md): module catalog and module-specific standards
4141
- [Process-PSModule](Modules/Process-PSModule/index.md): how modules are structured and built
4242
- [Template onboarding](Modules/Process-PSModule/template-quickstart.md): how to start from the template
4343

44-
## Cross-org guidance has moved
44+
## Cross-org guidance
4545

4646
Cross-org standards and reusable solution documentation are now canonical in [MSXOrg/docs](https://msxorg.github.io/docs/):
4747

0 commit comments

Comments
 (0)