Publish PowerShell help content using PlatyPS v1.0
summary
PlatyPS 1.0 GA provides a strong C# object model that generates markdown, converts to MAML or YAML, and enables automated testing and publishing; it processes ~450 files in seconds, runs Pester (322 tests, 24 failures reported) and exports HTML for static sites. The demo wires a GitHub Action that builds with Hugo and deploys to GitHub Pages, noting gotchas: MAML round‑tripping loses formatting and help URI vs .link precedence can surprise.
AI-written summary · about
chapters (13)
- 0:00PowerShell help docs intro
- 2:19PowerShell help system history
- 8:21PlatyPS for help authoring
- 15:20PlatyPS v1.0 object model
- 16:04Demo: PlatyPS in module
- 29:04Testing help with Pester
- 37:02PlatyPS object model
- 42:20Migrating to PlatyPS
- 47:00Hugo for static sites
- 57:45GitHub Actions publishing
- 1:03:56Module dev tips
- 1:11:19PowerShell docs style
- 1:13:45Q&A
related talks
01h 29mPlatyPS: PowerShell Help meets Markdown
01h 29mWhat's new in PlatyPS
41mI like good Docs, and I cannot lie
42mCreating PowerShell Projects and more with Plaster
49mStop manually publishing your modules. Automate it in 2 minutes!
01h 29mFull Stack PowerShell
46mCreating a Complex and Reusable HTML Reporting Structure
01h 45mWriting Award Winning PowerShell Functions and Script Modules