Skip to content

Write PowerShell External Help in Markdown

License

Notifications You must be signed in to change notification settings

3rdLearning/platyPS

 
 

Repository files navigation

PlatyPS

Original PlatyPS project README

PlatyPS is a PowerShell module that is used to update and maintain module help documentation and it is used by PLS 3rd Learning as part of its PowerShell module template.

This is an internal fork of PlatyPS that resolves an issue with the generation of help documentation that doesn't take into account new common parameters introduced in PowerShell version 7.4. This causes extra parameters to be included in the help documentation that shouldn't be there. See platyPS Issue #595 for more information. There is a pending pull request that resolves this but it doesn't look like it will be merged or fixed in version 1.x, and version 2.x remains unreleased.

Quick start

  • Install internal fork of the platyPS module from the PLS3rdLearning repository
Install-Module -Name platyPS -Scope CurrentUser -Repository PLS3rdLearning
Import-Module platyPS

See the Original PlatyPS project README for additional usage information.

Making a new release

See contributing guidelines for more information on development requirements.

  1. Make sure platyPS help itself (content in .\docs folder) is up to date. Update-MarkdownHelp -Path .\docs should result in no changes unless a new parameter is added.
  2. Change the version in platyps.psd1. The original module doesn't use it, but the internal fork uses it for publishing
  3. Publish the module to the Gallery: .\build.ps1 -Configuration Release -Publish:$true.
  4. Check the PLS3rdLearning repostiory to verify it is updated.

Congratulations! You just made a release.

About

Write PowerShell External Help in Markdown

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C# 54.5%
  • PowerShell 34.7%
  • JavaScript 5.6%
  • CSS 3.6%
  • HTML 1.6%