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

Rework documentation #33

Merged
merged 7 commits into from
Mar 8, 2022
Merged

Rework documentation #33

merged 7 commits into from
Mar 8, 2022

Conversation

smortex
Copy link
Collaborator

@smortex smortex commented Mar 7, 2022

Refresh the README and allow generation documentation using puppet-strings with rake reference.

Also include:

smortex added 6 commits March 7, 2022 11:53
New functions can be documented using Puppet strings.

While here, scope them to the module.  While this will break backward
compatibility, it is recommended not to define functions in the global
namespace.
Travis is dead.
By using Voxpupuli tooling, we can link to their documentation about
testing and remove the old module-specific tooling.
This can be used to generate REFERENCE.md, and has the added value of
reporting undocumented parameters / classes.
@smortex smortex requested a review from faxm0dem March 7, 2022 22:13
Copy link
Member

@faxm0dem faxm0dem left a comment

Choose a reason for hiding this comment

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

Disclaimer: I have 0 XP with puppet-strings
LGTM

@smortex smortex merged commit c0c6f48 into master Mar 8, 2022
@smortex smortex deleted the readme branch March 8, 2022 23:59
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.

2 participants