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

Fix puppet-strings documentation #1363

Merged
merged 1 commit into from
Aug 23, 2022
Merged

Fix puppet-strings documentation #1363

merged 1 commit into from
Aug 23, 2022

Conversation

ekohl
Copy link
Collaborator

@ekohl ekohl commented Aug 23, 2022

In 37e5bea an empty line was added, splitting the documentation block. Removing the empty line creates a single documentation block again.

Fixes: 37e5bea

In 37e5bea an empty line was added,
splitting the documentation block. Removing the empty line creates a
single documentation block again.

Fixes: 37e5bea
@ekohl ekohl requested a review from a team as a code owner August 23, 2022 15:47
@puppet-community-rangefinder
Copy link

postgresql::server is a class

Breaking changes to this file WILL impact these 38 modules (exact match):
Breaking changes to this file MAY impact these 17 modules (near match):

This module is declared in 70 of 579 indexed public Puppetfiles.


These results were generated with Rangefinder, a tool that helps predict the downstream impact of breaking changes to elements used in Puppet modules. You can run this on the command line to get a full report.

Exact matches are those that we can positively identify via namespace and the declaring modules' metadata. Non-namespaced items, such as Puppet 3.x functions, will always be reported as near matches only.

@@ -77,7 +77,7 @@
# @param roles Specifies a hash from which to generate postgresql::server::role resources.
# @param config_entries Specifies a hash from which to generate postgresql::server::config_entry resources.
# @param pg_hba_rules Specifies a hash from which to generate postgresql::server::pg_hba_rule resources.

#
Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Interestingly enough, this is why we have https://github.com/voxpupuli/puppet-lint-param-docs. However, it's disabled here and somehow doesn't catch it. That's a bug.

Copy link
Contributor

Choose a reason for hiding this comment

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

Amazing @ekohl thanks for this find!

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

It's the most common mistake I've seen with puppet-strings. When things disappear, look for empty lines.

@pmcmaw pmcmaw added the bugfix label Aug 23, 2022
@pmcmaw pmcmaw merged commit b2e365a into puppetlabs:main Aug 23, 2022
@pmcmaw pmcmaw mentioned this pull request Aug 24, 2022
3 tasks
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Documentation is incorrect, following v8.2.0 release
3 participants