Contributing

Help us to make this project better by contributing. Whether it’s new features, bug fixes, or simply improving documentation, your contributions are welcome. Please start with logging a JIRA and submit a pull request.

Before you contribute, please review these guidelines to help ensure a smooth process for everyone. Thanks :).

Copyright

JIRA Steps plugins is licensed under Apache License, Version 2.0

Issue reporting

• Please browse our existing issues before logging new issues.
• Check that the issue was not already fixed in the master branch.
• Open an issue with a descriptive title and a summary.
• Please be as clear and explicit as you can in your description of the issue.
• Include any relevant code in the issue summary.

Pull requests

• Follow Standard procedures in contributing to open source projects on Github.
  • Fork the project.
  • Use a feature branch.
  • Add good commit messages.
  • Use the same coding conventions as the rest of the project. This project is using Google StyleGuide.
  • Download StyleGuides from Github.
  • Commit locally and push to your fork until you are happy with your improvements.
  • Make sure to add tests and verify all the tests are passing when merging upstream.
  • Add an entry to the Change Log accordingly.
  • Squash commits before merging to master.
  • Open a pull request.
  • The pull request will be reviewed by the community and merged by the project committers.

Development

• Fork the repository.
• Clone the forked repository.
• Make the code changes.
• Add Tests
• Open a pull request directly from the forked repository.

Testing

• Spin up docker instances for JIRA and JENKINS locally or install JIRA and JENKINS on your machine.
• Configure Jenkins
• Run mvn package from command line or terminal.
• jira-steps-plugin.hpi file can be found in target folder of the project.
• Install plugin manually using .hpi file in jenkins.
• Test your functionality.
• It helps reviewers if the screenshots of these evidences are added in the pull request.

Note: This plugin requires JDK 1.8 and latest maven version to build.

Updating Documentation

• This plugin currently using github pages site and Hugo for hosting the project documentation.
• Documentation can be updated in jira-steps-plugin/hugo/ folder.
• Install hugo brew install hugo.
• Navigate to hugo foloder cd jira-steps-plugin/hugo.
• Pull the docdock submodule git submodule update --init --force.
• Start hugo hugo server -D.
• Local site should be available at http://localhost:1313/jira-steps-plugin/.
• Change the content as needed and the changes should refresh automatically (if not refresh web page).