Skip to content

Feature: Add support for additional PlatyPS MarkdownHelp parameters (#77) #78

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
May 20, 2025

Conversation

joshooaj
Copy link
Member

@joshooaj joshooaj commented May 19, 2025

Description

  • Add AlphabeticParamsOrder, ExcludeDontShow, and UseFullTypeName options to $PSBPreference.Docs with default value of $false in build.properties.ps1
  • Add the same three parameters to Build-PSBuildMarkdown
  • Pass the same three parameters to Build-PSBuildMarkdown from IB.tasks.ps1 and psakeFile.ps1
  • Add the same three parameters to the list of configurable options in the readme file

Related Issue

#77

Motivation and Context

I want to have parameters sorted alphabetically in my markdown documentation, and I do not want to show parameters in the documentation with the DontShow attribute. I don't need to set the UseFullTypeName parameter, but it was easy enough to also include this parameter that New-MarkdownHelp and Update-MarkdownHelp have in common.

How Has This Been Tested?

No additional tests have been added yet, but the existing tests still pass.

Checklist:

  • My code follows the code style of this project.
  • I have updated the documentation accordingly.
  • I have added this change to the CHANGELOG.md.
  • I have read the CONTRIBUTING document.
  • I have added tests to cover my changes.
  • All new and existing tests passed.

Copy link
Member

@HeyItsGilbert HeyItsGilbert left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good!

joshooaj added 2 commits May 19, 2025 20:38
…ke#77)

* Add `AlphabeticParamsOrder`, `ExcludeDontShow`, and `UseFullTypeName` options to `$PSBPreference.Docs` with default value of `$false` in `build.properties.ps1`
* Add the same three parameters to `Build-PSBuildMarkdown`
* Pass the same three parameters to `Build-PSBuildMarkdown` from `IB.tasks.ps1` and `psakeFile.ps1`
* Add the same three parameters to the list of configurable options in the readme file
@joshooaj joshooaj force-pushed the joshooaj/feat-77 branch from 35424f1 to 04e2b1c Compare May 20, 2025 03:38
@joshooaj joshooaj merged commit 7890486 into psake:main May 20, 2025
5 of 6 checks passed
@joshooaj joshooaj deleted the joshooaj/feat-77 branch May 20, 2025 03:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants