I have a question or a problem!
- Suggesting enhancements
- Working on an existing issue or enhancement
- Working on a new issue or enhancement
Code Base Contribution Guidelines
What can I expect from the ISIS3 development team
Development Process Checklists
If you have a question about or a problem with ISIS3, please see the Redmine Issues section.
If you have a question or a problem with contributing to our software please contact mshepherd@usgs.gov
Redmine is our ticket tracking tool. If you have a question about, a problem with, or a suggestion for ISIS3, please read our Guidelines for reporting Redmine issues. Once you have read that please submit a Redmine issue.
- Find a issue or enhancement that you want to work on. Check Redmine issues to see if there has been a ticket reported about it. If one does not exist that addresses what you want to work on, make a ticket.
- Assign the Redmine issue to yourself. If you don't have the permission to do this, please make a note on the issue indicating that you would like to work on it.
- Propose a solution on the redmine issue.
- Work with an ISIS3 developer, the issue reporter, and any other interested parties to get feedback on your solution. This may be an iterative process.
- Add an impact statement to the redmine issue. If you don't have the permission to do this, please make a note on the issue with the impact statement.
- Make the changes on your fork of the ISIS3 main GitHub repo. Follow the Code Base Contribution Guidelines.
- Follow the Developer's Checklist to ensure your changes are ready for review.
- Make a pull request. Include the redmine issue number in the title of the pull request. Use the "Fixes #0000" format.
- Work with your code reviewer, tester, and reporter to improve your changes. Your pull request will not be merged in until all parties approve the changes.
- Check in your test data. If you are an outside contributer, work with your code reviewer to ensure your tests and test data get checked in.
- Please create a Redmine issue.
- Indicate in the comments of your issue that you would like to work on the issue or enhancement.
- Follow the Working on an existing issue or enhancement steps.
The following is a set of guidelines for contributing to ISIS3.
- Personal style changes will not be accepted.
- Changes to bring code closer to our Coding Standards and Style Guide are encouraged.
- Please be professional, even in comments.
- Variable names must be meaningful.
- All modified code is required to pass our Coding Standards and Style Guide.
- You must write or update tests to exercise any modified code.
- You must provide test data for any new or modified tests.
- You must have a Redmine issue assigned to you before submitting a pull request.
- You must complete the Developer Checklist before submitting your pull request.
- When submitting a pull request, you must include the Redmine issue number in the title of the pull request. Use the "Fixes #0000" format (#0000 being the Redmine ticket number).
Our response time will depend on availability and scheduling.
Our feedback will address any discrepancies related to the contribution guidelines, our coding standards and style guide, and our code review checklist.