Skip to content

Instantly share code, notes, and snippets.

@thiamsantos
Created March 12, 2017 00:52
Show Gist options
  • Save thiamsantos/4e2d830865fd50559af255221824e0a6 to your computer and use it in GitHub Desktop.
Save thiamsantos/4e2d830865fd50559af255221824e0a6 to your computer and use it in GitHub Desktop.
Example of a contributing file

Contributing to project-name

First off, thanks for taking the time to contribute!

Now, take a moment to be sure your contributions make sense to everyone else. These are just guidelines, not rules. Use your best judgment, and feel free to propose changes to this document in a pull request.

Reporting Issues

Found a problem? Want a new feature? First of all see if your issue or idea has already been reported. If don't, just open a new clear and descriptive issue.

Submitting pull requests

Pull requests are the greatest contributions, so be sure they are focused in scope, and do avoid unrelated commits.

  • Fork it!
  • Clone your fork: git clone https://github.com/<your-username>/<project-name>
  • Navigate to the newly cloned directory: cd project-nam
  • Create a new branch for the new feature: git checkout -b my-new-feature
  • Install the tools necessary for development: npm install
  • Make your changes.
  • Commit your changes: git commit -am 'Add some feature'
  • Push to the branch: git push origin my-new-feature
  • Submit a pull request with full remarks documenting your changes.

Testing

Every time you write a test, remember to answer all the questions:

  1. What are you testing?
  2. What should it do?
  3. What is the actual output?
  4. What is the expected output?
  5. How can the test be reproduced?

Code Style

Follow the xo style. Using two spaces for identation and no semicolons.

Scripts

The follow scripts are available when you develop.

  • npm test - Run the tests one time.
  • npm test:watch - Watch and run the tests.
  • npm run lint - Lint the files.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment