Commit 53f56c3
🚀 [Feature]: Module catalog now shows release and Process-PSModule status (#74)
The module catalog now provides operational module status at a glance:
each module entry links to its own generated page, shows current
module/release information, and exposes Process-PSModule workflow usage
status with live repository activity metrics.
## New: Module-specific catalog pages
Each module name in the catalog now links to a generated module page
under `src/docs/Modules/Catalog/Repositories/`. The page includes
repository metadata, version information, README-derived summary
content, and direct links for maintenance activity.
## Changed: Catalog entries provide richer status signals
Catalog rows now use expanded columns: Name, Version, ProcessVersion,
Issues, PRs, and Stars. Name links include a sanitized/truncated
README-based hover preview so maintainers can quickly understand module
purpose without leaving the catalog.
## Changed: Process-PSModule usage is now visible per module
For each module repository, the catalog now attempts to detect the
reusable Process-PSModule workflow reference and reports both the
referenced value and computed status (for example `up-to-date`,
`behind`, `sha-pinned`, `not-configured`).
## Changed: Catalog refresh is now scheduled
The Docs workflow now includes a weekly scheduled run so generated
catalog data refreshes even when no direct docs edits are pushed.
## Technical Details
- Extended `.github/actions/update-index/src/main.ps1` to pass
discovered repositories into module catalog generation.
- Extended `.github/actions/update-index/src/Helper.psm1` with:
- GitHub API data retrieval for releases/tags, README, issues, PRs, and
workflow content.
- Response-unwrapping logic for GitHub module API wrapper shapes.
- README summary extraction and HTML attribute sanitization for hover
previews.
- Per-module page generation under
`src/docs/Modules/Catalog/Repositories/`.
- Process-PSModule reference parsing from module workflow files and
status classification.
- Local testing compatibility improvements for authenticated user
contexts and expected 404 handling for optional workflow files.
- Added weekly schedule trigger to `.github/workflows/Docs.yml`.
- Updated catalog documentation text to describe generated table/page
behavior.
<details>
<summary>Related issues</summary>
-No linked issue (requested directly in coordinated session)
</details>
---------
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>1 parent 88c92d8 commit 53f56c3
14 files changed
Lines changed: 619 additions & 50 deletions
File tree
- .github
- actions/update-index
- src
- templates/module-catalog
- workflows
- src/docs
- Modules
- Catalog
- assets/images/module-catalog
Large diffs are not rendered by default.
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
1 | 1 | | |
2 | 2 | | |
3 | | - | |
| 3 | + | |
4 | 4 | | |
5 | 5 | | |
6 | | - | |
| 6 | + | |
Lines changed: 17 additions & 0 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
| 1 | + | |
| 2 | + | |
| 3 | + | |
| 4 | + | |
| 5 | + | |
| 6 | + | |
| 7 | + | |
| 8 | + | |
| 9 | + | |
| 10 | + | |
| 11 | + | |
| 12 | + | |
| 13 | + | |
| 14 | + | |
| 15 | + | |
| 16 | + | |
| 17 | + | |
Lines changed: 9 additions & 0 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
| 1 | + | |
| 2 | + | |
| 3 | + | |
| 4 | + | |
| 5 | + | |
| 6 | + | |
| 7 | + | |
| 8 | + | |
| 9 | + | |
Lines changed: 9 additions & 0 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
| 1 | + | |
| 2 | + | |
| 3 | + | |
| 4 | + | |
| 5 | + | |
| 6 | + | |
| 7 | + | |
| 8 | + | |
| 9 | + | |
Lines changed: 12 additions & 0 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
| 1 | + | |
| 2 | + | |
| 3 | + | |
| 4 | + | |
| 5 | + | |
| 6 | + | |
| 7 | + | |
| 8 | + | |
| 9 | + | |
| 10 | + | |
| 11 | + | |
| 12 | + | |
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
2 | 2 | | |
3 | 3 | | |
4 | 4 | | |
| 5 | + | |
| 6 | + | |
5 | 7 | | |
6 | 8 | | |
7 | 9 | | |
| |||
28 | 30 | | |
29 | 31 | | |
30 | 32 | | |
| 33 | + | |
31 | 34 | | |
32 | 35 | | |
33 | 36 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
14 | 14 | | |
15 | 15 | | |
16 | 16 | | |
17 | | - | |
| 17 | + | |
18 | 18 | | |
19 | 19 | | |
20 | 20 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
16 | 16 | | |
17 | 17 | | |
18 | 18 | | |
19 | | - | |
| 19 | + | |
20 | 20 | | |
21 | 21 | | |
Loading
0 commit comments