We encourage everyone to make contribution to the project! If you want to make ExtWebDriver better with new features, enhancements or bug fixes, here's how you can contribute.

• Create a GitHub account
• Submit a ticket in GitHub project (please verify the ticket doesn't already exist by searching here)
• We will assign you to the ticket once the ticket is approved.
• Fork the repository in GitHub
• Code code code!
• Create unit/integration tests
• For every class you are writing/modifying, you must create/modify unit or integration tests
• Unit Tests: Write unit tests for classes which do not require execution against a deployed app running on a browser
• Integration Tests:
• All integration tests run against a locally deployed app (static HTML files under 'src/test/resources/webapp')
• You may extend an existing HTML to test your code or create a new HTML
• You should not break existing tests
• Build
• mvn package
• Compile code
• Create package jar
• mvn verify
• Compile
• Deploy local app on Jetty server (default port is 9090)
• Run integration tests (unit tests)
• Make a pull request
• Include reference to the ticket
• After review, the pull request will be merged to the master

When you make a pull request, you must sign off your work. You can automatically sign off by using "git commit -s" command. When you sign off, you are making an agreement to the following:

Developer's Certificate of Origin (adapted from the linux kernel)

By making a contribution to this project, I certify that:

1. The contribution was created in whole or in part by me and I have the right to submit it under the open source license indicated in the file; or
2. The contribution is based upon previous work that, to the best of my knowledge, is covered under an appropriate open source license and I have the right under that license to submit that work with modifications, whether created in whole or in part by me, under the same open source license (unless I am permitted to submit under a different license), as indicated in the file; or
3. The contribution was provided directly to me by some other person who certified (a), (b) or (c) and I have not modified it.
4. I understand and agree that this project and the contribution are public and that a record of the contribution (including all personal information I submit with it, including my sign-off) is maintained indefinitely and may be redistributed consistent with this project or the open source license(s) involved.

Links to additional resources

• GitHub Help
• Making a Pull Request on GitHub

When you encounter bugs, please try to find out if the issue has already been reported by searching here. Once you identify that your issue is new, please create a new ticket by clicking 'New Issue'. Please make sure you provide a clear description of the issue along with a testable scenario.

If you want to get involved in fixing bugs, first read the steps outlined above under "Contribute". Then, you can notify the team by adding a comment. Then we will assign the bug to you and you can start developing your code. Once you complete your code, build and test it, please make a pull request for review. Once the review is complete, your code fix will be merged into master branch within the JTAF-ExtWebDriver repository.

If you want to get involved, you can start by contributing to the GitHub project.

If you have any questions or discussion topics, please post them on Google Groups

---