feat(modules): add /modules/ section with reusable Module landing pages#17
Merged
Conversation
Introduce a hybrid layout for the open-source modules PowerShell.org stewards: a generic, front-matter-driven `module` layout for new modules, with the Hugo `layout:` key as an escape hatch so flagship modules can stay bespoke (Plaster). - Add /modules/ section index (card grid over pages) and move Plaster under it at /modules/plaster/ with an alias from /plaster/ (bespoke layout unchanged). - Add PSDepend as the first generic Module, authored from its README/glossary, with its real logo imported to static/images/modules/. - Add a reusable `terminal` shortcode for Plaster-style code blocks (Prism highlighting) plus a .ps-terminal CSS reset so .prose pre doesn't fight it. - Make the top-nav dropdown generic via a childMenu param; Modules becomes a dropdown like Community, listing each module. - Add a `modules` archetype (bakes in the load-bearing `layout:` key), CONTEXT.md glossary entry for "Module", and ADR-0001 recording the decision. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01T5qXD5Xg7YL1gpyhSN3WS1
✅ Deploy Preview for powershellorg ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Adds a
/modules/section to the site for the open-source modules PowerShell.org stewards, with a hybrid rendering approach: a generic, front-matter-drivenmodulelayout for new modules, plus the Hugolayout:escape hatch so a flagship module can stay bespoke (Plaster keeps its hand-authored page).Changes
/modules/index — card grid ranging over the module pages (mirrors the Community list pattern)./modules/plaster/with an alias from/plaster/; its bespoke layout is unchanged.static/images/modules/.terminalshortcode — reusable Plaster-style code blocks (dark terminal chrome + Prism highlighting), plus a.ps-terminalCSS reset so.prose prestyling doesn't fight it. PSDepend's code samples use it.childMenuparam drives the dropdown, so "Modules" is now a dropdown like "Community" listing each module.modulesarchetype (bakes in the requiredlayout:key), aCONTEXT.mdglossary entry for the term Module (with the disambiguation against PowerShell's generic sense), and ADR-0001 recording the architecture/IA decision.Adding a module later
hugo new --kind modules content/modules/<name>/_index.mdand fill in the front matter.modulesmenu inhugo.yaml.Verification
hugo --gc --minifybuilds clean (exit 0)./modules/,/modules/plaster/,/modules/psdepend/render;/plaster/redirects to/modules/plaster/; PSDepend shows its logo + terminal-styled code blocks; both nav dropdowns work.🤖 Generated with Claude Code