Skip to content
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

(GH-153) Ensure generated readme contains module name info #163

Merged

Conversation

david22swan
Copy link
Member

@david22swan david22swan commented Jun 2, 2021

This commit corrects a bug where the auto-generated readme was missing the PowerShell and Puppet module names from various locations in the output markdown.
Those values were not being passed by New-PuppetDscModule to Update-PuppetModuleReadme.

Also includes work to increase parameter validation within Update-PuppetModuleReadme and Get-Readmecontent to help catch any empty or null values and make parameters mandatory.

Resolves #153

@david22swan david22swan added the enhancement New feature or request label Jun 2, 2021
@david22swan david22swan self-assigned this Jun 2, 2021
@david22swan david22swan force-pushed the #153/main/auto-generate_readme branch 2 times, most recently from 0a5d9c0 to a6fda56 Compare June 2, 2021 13:55
Copy link

@michaeltlombardi michaeltlombardi left a comment

Choose a reason for hiding this comment

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

Could you also add a changelog entry to this (should get an entry in the Fixed section) and update the commit to be something like:

(GH-153) Ensure generated readme contains module name info

This commit corrects a bug where the auto-generated readme
was missing the PowerShell and Puppet module names from
various locations in the output markdown.

Those values were not being passed by New-PuppetDscModule
to Update-PuppetModuleReadme.

This commit also updates tests to ensure the values are passed.

Resolves #153

The changelog entry should match the format of the other entries (linking to the issue) and have a message like:

Ensure puppetized module READMEs include the PowerShell and Puppet module names where needed in the markdown.

@michaeltlombardi michaeltlombardi changed the title (#153) - Autogenerated Module Readme updated to included Module Name and Version (GH-153) Ensure generated readme contains module name info Jun 2, 2021
@david22swan david22swan force-pushed the #153/main/auto-generate_readme branch 11 times, most recently from 089425a to 01026f5 Compare June 3, 2021 16:57
Copy link

@michaeltlombardi michaeltlombardi left a comment

Choose a reason for hiding this comment

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

Minor request for changelog entry modifications.

(non-blocking): If this PR could be broken into three commits (one for each modified function), that would be preferable.

CHANGELOG.md Outdated Show resolved Hide resolved
CHANGELOG.md Outdated Show resolved Hide resolved
CHANGELOG.md Outdated Show resolved Hide resolved
This commit corrects a bug where the auto-generated readme was missing the PowerShell and Puppet module names from various locations in the output markdown.
Those values were not being passed by New-PuppetDscModule to Update-PuppetModuleReadme.
…-PuppetModuleReadme`

Makes all `Update-PuppetModuleReadme` parameters except `PuppetModuleName` mandatory and do not accept null or empty values.
PuppetModuleName` is excluded from this change as it is handled by a separate set of logic that uses the `PowerShellModuleName` in its place should it not be set or be set as an empty string.
@david22swan david22swan force-pushed the #153/main/auto-generate_readme branch from 01026f5 to 28b7a99 Compare June 3, 2021 17:37
…mecontent`

Makes the `PowerShellModuleName` and `PuppetModuleName` parameters in `Get-Readmecontent` mandatory and rejects null or empty values for any parameters
@david22swan david22swan force-pushed the #153/main/auto-generate_readme branch from 28b7a99 to c1deca4 Compare June 3, 2021 17:38
@david22swan
Copy link
Member Author

Have updated the changelog and split the commit into 3 commits

@michaeltlombardi michaeltlombardi marked this pull request as ready for review June 4, 2021 12:00
@michaeltlombardi michaeltlombardi requested a review from a team as a code owner June 4, 2021 12:00
@michaeltlombardi michaeltlombardi merged commit 497eee9 into puppetlabs:main Jun 4, 2021
@david22swan david22swan deleted the #153/main/auto-generate_readme branch June 4, 2021 12:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Autogenerated Module Readme does not include the PowerShell or Puppet Module Names
2 participants