If Playbook is exhibiting unexpected behavior, please file an issue that allows the maintainers to reproduce the results you see. You may also use issues to submit feature requests.
- Pick a title that describes intent clearly
- Describe in as much detail as possible the steps you took to reach the unexpected behavior
- Describe the unexpected behavior (e.g. – a stack trace with the error or a screen shot)
- Describe the expected behavior
- Please describe your environment (e.g. – versions of OS, Ruby, Node and Playbook you are using)
- Clone the repository
- Make your changes in a topic branch
- Rebase against
origin/master - Submit a pull request
In order to see and test the changes you've made to Playbook, you'll need to uninstall any previously installed versions of Playbook and link your local Playbook.
npm uninstall -g generator-playbookcd path/to/playbook/reponpm linkcd path/to/desired/locationyo playbook
The resulting Playbook generator will be referencing your local copy of the Playbook repository rather than an installed published release.
- Capitalize your commit messages
- Start your message with a verb
- Use present tense
- Refer to the issue/PR number in your squashed commit message
- Update the package version in
package.json. This should match the version number that you intend to publish to npmjs.org. - Commit your version bump:
git commit -am "Prepare #.#.# release" - Create an annoted git tag for the release:
git tag -a v#.#.# -m "Version #.#.#" - Push master/tags:
git push origin master --tags - Publish to npm:
npm publish
NOTE: Playbook is using semver. Do not break this pattern.