We love pull requests. Here's a quick guide:
- Check for existing issues for duplicates and confirm that it hasn't been fixed already in the master branch
- Fork the repo, and clone it locally
npm link
to make your cloned repo available to npmhubot --create testbot
to create a bot to test against (no automated tests yet 😭)npm install && npm link hubot
in your newly created bot to install dependencies, and use your hubot fork- Push to your fork and submit a pull request.
At this point you're waiting on us. We like to at least comment on, if not accept, pull requests within a few days. We may suggest some changes or improvements or alternatives.
Some things that will increase the chance that your pull request is accepted:
- Use CoffeeScript idioms and style guide
- Update the documentation, the surrounding one, examples elsewhere, guides, whatever is affected by your contribution
- Include any information that would be relevant to reproducing bugs, use cases for new features, etc.
- Impact on existing hubot installs, hubot adapters, and hubot scripts (e.g. backwards compatibility)
Syntax:
- Two spaces, no tabs.
- No trailing whitespace. Blank lines should not have any space.
- Prefer
and
andor
over&&
and||
- Prefer single quotes over double quotes unless interpolating strings.
MyClass.myMethod(my_arg)
notmyMethod( my_arg )
ormyMethod my_arg
.a = b
and nota=b
.- Follow the conventions you see used in the source already.