Thanks for taking a look at our contribution guidelines. This is a small open-source project and we’re always looking to get more people actively involved in its development and direction, even if you can’t send code!
For bugs, please open a ticket, providing a description of the problem, reproduction steps, expected result, and actual result. It’s very hard for us to solve your problem without all of this information.
For feature requests, open a ticket describing what you’d like to see and we’ll try to figure out how it can happen! We (and all the other Intern users) would really appreciate it if you could also pitch in to actually implement the feature (maybe with some help from us?).
It’s not that important, but if you can, try to post to the correct issue tracker for your problem:
- Dig Dug should be used for issues regarding downloading or starting service tunnels, or interacting with a service provider’s REST API
- Leadfoot should be used for issues with any of the functional testing APIs, including issues with cross-browser inconsistencies or unsupported Selenium environments
- Intern for all other issues
Note that we prefer to keep the issue tracker focused on development tasks. If you have questions about using Intern or writing tests, please see our Help doc.
Because Intern is a small project, any contribution you can make is much more impactful and much more appreciated than anything you could offer to big OSS projects that are already well-funded by big corporations like Google or Facebook.
If you want to get involved with the sexy, sexy world of testing software, but aren’t sure where to start, come talk to us on Gitter or look through the list of help-wanted tickets for something that piques your interest. The development team is always happy to provide guidance to new contributors!
If you’re not a coder (or you just don’t want to write code), we can still really use your help in other areas, like improving documentation, performing marketing and outreach, or helping other users, so get in touch if you’d be willing to help in any way!
Like most open source projects, we require everyone to sign a contributor license agreement before we can accept any non-trivial pull requests. This project belongs to the same foundation as other great OSS projects like Dojo, Grunt, lodash, and RequireJS, so one e-signature makes you eligible to contribute to all of these projects!
Code style should be consistent with the existing code. We use prettier for styling, so run any new or changed files through that before committing. If possible and appropriate, updated tests should also be a part of your pull request. (If you’re having trouble writing tests, we can help you with them!)
- Please make sure to provide rigorous code review on new contributions
- When in doubt, ask for a second review; don’t commit code that smells wrong just because it exists
- Squash pull requests into a single commit using
git rebase -iafter a merge. Don’t use the shiny green button! No merge commits allowed! - Put
[ci skip]at the end of commit messages for commits that do not modify any code (readme changes, etc.)