Skip to content

Conversation

@david22swan
Copy link
Member

@david22swan david22swan commented Sep 18, 2023

README is barebones and contains little information. Updating to include more detailed instructions and what it is and how to use it.

Checklist

  • 🟢 Spec tests.
  • 🟢 Acceptance tests.
  • Manually verified.

@david22swan david22swan added the maintenance maintenance label Sep 18, 2023
@david22swan david22swan requested a review from a team as a code owner September 18, 2023 08:47
@david22swan david22swan force-pushed the cat-1345/main/update_readme branch 2 times, most recently from 1838a47 to 84c873d Compare September 18, 2023 08:50
@david22swan david22swan changed the title (CAT-1345) Update module README.md (CAT-1345) Update gem README.md Sep 18, 2023
README is barebones and contains little information. Updating to include more detailed instructions and what it is and how to use it.
@david22swan david22swan force-pushed the cat-1345/main/update_readme branch from 84c873d to 735f27e Compare September 18, 2023 09:10
Copy link
Contributor

@LukasAud LukasAud left a comment

Choose a reason for hiding this comment

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

LGTM

@LukasAud LukasAud merged commit 2b8b77f into puppetlabs:main Sep 18, 2023
@david22swan david22swan deleted the cat-1345/main/update_readme branch September 18, 2023 10:56
Copy link
Contributor

@ekohl ekohl left a comment

Choose a reason for hiding this comment

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

I like the expansion. Bit late, but please consider my suggestions for a follow up.

## Development
For conveniances sake the `puppet-modulebuilder` gem has been included within the `PDK` and as such can be called on to run against a module from within it using the build command as shown below:

```ruby
Copy link
Contributor

Choose a reason for hiding this comment

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

This isn't ruby


The purpose of this tool is to take a given local module directory and compile it into a `.tar` file, known as the `tarball`, that can then be installed directly by Puppet on a target machine or uploaded onto the [Puppet Forge](https://forge.puppet.com/) so that it can be accessed publicly.

As part of this process any non-deliverable aspects of the module, parts of it related to the modules development or testing for example, are stripped away leaving only the documentation and the puppet/ruby code that is needed for the module to function.
Copy link
Contributor

Choose a reason for hiding this comment

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

Should it describe which files it reads here? Like .gitignore, .pmtignore, .pdkignore and in which order?

Copy link
Member Author

Choose a reason for hiding this comment

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

Created a new PR with an update: #62

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

maintenance maintenance

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants