Contributing

We welcome you to join the development of Divvy. This document will help you through the process.

Before You Start

Please follow the coding style:

Workflow

  1. Fork [kitware/divvy].

  2. Clone the repository to your computer and install dependencies.

    $ git clone https://github.com/<username>/divvy.git
    $ cd divvy
    $ npm install
  3. Create a feature branch.

    $ git checkout -b new_feature
  4. Start hacking.

  5. Use Commitizen for commit message

    $ npm run commit
  6. Push the branch:

    $ git push origin new_feature
  7. Create a pull request and describe the change.

Notice

  • Don’t modify version number in package.json.

  • Your pull request will only get merged when tests passed. Don’t forget to run tests before submission.

    $ npm test

Updating Documentation

The divvy documentation is part of the code repository and is entirely written in markdown. The source for this page for example is located at Documentation/content/docs/misc_contributing.md.

Reporting Issues

When you encounter problems using divvy you may be able to find the solutions in Troubleshooting, onGitHub. If you can’t find the answer, please report it on GitHub.