These docs are for people building and maintaining the PowerShell.org website — the Hugo theme, asset pipeline, integrations, and the decisions behind them.
Just want to contribute content? Adding an article, podcast note, author profile, or community event needs none of this. Start at the repo root:
README.mdfor orientation andCONTRIBUTING.mdfor the step-by-step.
- development.md — build, theme, asset pipeline, deployment, and troubleshooting for the site.
Records of why the site is built the way it is.
- 0001 — Module landing pages
- 0002 — Author profiles
- 0003 — Incremental podcast sync
- 0004 — GitHub alert admonitions
- 0005 — Author analytics
- 0005 — SEO metadata and purged, self-hosted assets
Publishing selected Discord channel content to /discord/ on the site.
- Quick start — get it running.
- Deployment guide — secrets, config, validation.
- Moderation guide — publication controls and policies.
- podcast-sync-plan.md — plan for keeping The PowerShell Podcast in step with the repo.
- agents/ — instructions for AI agents working in this repo
(issue tracker, triage labels, domain docs). See also
../AGENTS.md.
Shared vocabulary for the project (Module, Author, Profile, Reach, the two
podcasts) lives in CONTEXT.md at the repo root. Read it before
naming things or changing how content is modeled.