Describe the framework-first documentation hierarchy

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Author: MariusStorhaug

docs/content/Modules/Catalog/index.md

@@ -2,6 +2,8 @@
 
 This catalog tracks modules maintained in the PSModule organization and what each module does.
 
+The catalog is separate from the [Process-PSModule framework](../Process-PSModule/index.md). Use the framework documentation to build and release a module; use this page to discover the modules available to install and use.
+
 ## Scope
 
 Each module page should capture:

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

@@ -32,6 +32,19 @@ New to Process-PSModule? Work through these in order.
 | [Repository setup](get-started/repository-setup.md) | Configure GitHub Pages, the PowerShell Gallery API key, permissions, and the caller workflow. |
 | [Your first release](get-started/your-first-release.md) | The pull request flow, version labels, and what happens on merge. |
 
+## Module development foundations
+
+The framework automates a module's lifecycle; these conventions define the module it builds and releases.
+
+| Page | Description |
+| --- | --- |
+| [Module development foundations](../index.md) | The full set of module-authoring conventions supported by the framework. |
+| [Repository Standard](../Repository-Standard.md) | Required repository files, metadata, onboarding, and workflow wiring. |
+| [PowerShell module standard](../Standards.md) | Source layout, function design, and module-specific implementation conventions. |
+| [Module types](../Module-Types.md) | Conventions for integration (API) and data modules. |
+| [Test Specification](../Test-Specification.md) | Consistent Pester test structure and coverage expectations. |
+| [Versioning](../Versioning.md) | Semantic version changes based on public API impact. |
+
 ## Guides
 
 Task-oriented deep dives into the pipeline's functionality.

docs/content/Modules/index.md

@@ -1,19 +1,13 @@
-# Modules
+# Module development foundations
 
-Process-PSModule now hosts PSModule-org module documentation.
+Process-PSModule is the framework for building, testing, versioning, documenting, and publishing PowerShell modules. These foundations define the repository, source, test, and release conventions that the framework supports and validates.
 
-This section is the local source of truth for:
+Start with the [Process-PSModule overview](Process-PSModule/index.md) to understand the workflow. Use these pages when creating or maintaining a module that runs through it.
 
-- module catalog and module-level specs
-- Process-PSModule structure and build flow
-- repository anatomy and template onboarding
-
-## Sections
-
-- [Repository Standard](Repository-Standard.md)
-- [Standards](Standards.md)
-- [Module types](Module-Types.md)
-- [Test Specification](Test-Specification.md)
-- [Versioning](Versioning.md)
-- [Catalog](Catalog/index.md) (auto-generated from PSModule repo metadata, release data, and README summaries)
-- [Process-PSModule](Process-PSModule/index.md)
+| Page | Use it for |
+| --- | --- |
+| [Repository Standard](Repository-Standard.md) | Creating a module repository with the required metadata, files, and framework wiring. |
+| [PowerShell module standard](Standards.md) | Structuring source code, designing functions, and applying module-specific conventions. |
+| [Module types](Module-Types.md) | Applying conventions for integration (API) and data modules. |
+| [Test Specification](Test-Specification.md) | Writing consistent, comprehensive Pester tests for module functions. |
+| [Versioning](Versioning.md) | Choosing semantic version changes from the module's public API impact. |

docs/content/index.md

@@ -33,13 +33,13 @@ We empower PowerShell-savvy developers to effortlessly transform their ideas int
 
 Where we are headed is tracked as [objectives and initiatives](https://msxorg.github.io/docs/Ways-of-Working/Goal-Setting/).
 
-## PSModule documentation
+## Process-PSModule framework
 
-This site covers PSModule organization-specific documentation:
+This site is the documentation home for the Process-PSModule framework: the reusable workflow that builds, tests, versions, documents, and publishes PowerShell modules.
 
-- [Modules](Modules/index.md): module catalog and module-specific standards
-- [Process-PSModule](Modules/Process-PSModule/index.md): how modules are structured and built
-- [Template onboarding](Modules/Process-PSModule/get-started/index.md): how to start from the template
+- [Process-PSModule](Modules/Process-PSModule/index.md): start with the workflow, then follow its getting-started path, guides, reference, and specification.
+- [Module development foundations](Modules/index.md): the repository, source, module-type, test, and versioning conventions that the framework supports.
+- [Catalog](Modules/Catalog/index.md): discover modules maintained in the PSModule organization.
 
 ## Cross-org guidance