We need your help to making VersionOne IssueSync for JIRA a useful integration! While third-party patches are absolutely essential, they are not the only way to get involved. You can help the project by discovering and reporting bugs, helping others on StackOverflow, and reporting defects or enhancement requests as GitHub issues.
Before reporting a bug on the integration's issues page, first make sure that your issue is caused by the integration. Second, search the already reported issues for similar cases, and if it has been reported already, just add any additional details in the comments.
After you made sure that you have found a new bug, here are some tips for creating a helpful report that will make fixing it much easier and quicker:
- Write a descriptive, specific title. Bad: Problem with filtering. Good: Scope.Workitems always returns an empty list.
- Whenever possible, include Function info in the description.
- Create a simple test case that demonstrates the bug.
If you are not yet familiar with the way GitHub works (forking, pull requests, etc.), be sure to read the article about forking on the GitHub Help website — it will get you started quickly.
You should always write each batch of changes (feature, bugfix, etc.) in its own branch. Please do not commit to the master branch, or your unrelated changes will go into the same pull request.
You should also follow the code style and whitespace conventions of the original codebase.
Before sending a pull request with a new feature, first check if it has been discussed before already (either on GitHub issues. If your feature or improvement did get merged into master, please consider submitting another pull request.
Regardless of whether attribution is required by included code or a dependency, we want to acknowledge the work that VersionOne IssueSync for JIRA depends on and make it easy for people to evaluate the legal implications of using this integration. Therefore, all dependencies should be attributed in the ACKNOWLEDGEMENTS.md file. This should include the persons or organizations who contributed the libraries, a link to the source code, and a link to the underlying license.