Skip to content
This repository has been archived by the owner on Feb 13, 2019. It is now read-only.

How to Contribute

Sayed Ibrahim Hashimi edited this page Apr 1, 2015 · 5 revisions

Contributing is easy. Follow the steps below.

  1. Find an issue to fix on the issues page. If you have an idea that's not listed go ahead and create a new issue to discuss it.
  2. Comment on the issue that you're interested in taking ownership of. Include details of your proposed changes.
  3. One of the contributors will comment back and eventually assign the item to you

How to update the yeoman generator

The code for the yeoman generator is located at index.js. If you need to make changes to that make them in a feature branch and send changes in a PR to the master branch. A contributor will comment back and eventually merge the changes. On release these changes will be merged to the release branch and the npm package will be updated.

How to make changes to the templates

The templates for the project types are stored in the /samples directory and each subgenerator has its own directory.

Tests

If you make changes or additions to the generator, make sure that the existing tests in the /tests directory are also edited OR new tests are added to cover the new functionality and the tests pass.

You should make changes in a new feature branch and test them locally. When testing locally if you run the samples from the source directory make sure not to check in any files which are not needed. All files in the repo will be created in the project when the generator is used. Because of this you should not check in files like .gitignore.

When your changes are in good shape submit a PR and reference the issue that it relates to. One of the contributors will comment on the PR/issue and eventually merge it.

Clone this wiki locally