Choosing Something to Work On
- Anne Urban
Pick a Feature or Bug
Make Sure You're Not Duplicating Someone Else's Effort
Next, Check the issue tracker for Your Bug or Feature
Features:
- Review the feature backlog in the issue tracker
- and the open pull requests to see whether your feature idea is already logged and perhaps already under development
- Consult the PBS /wiki/spaces/~agurban/pages/6193157 to see whether there are plans for related work
- If your proposed feature is not already logged, if you want, you can file an RFE in the issue tracker but you don't need to
- You will have to create a pull request after your external design is signed off
Bugs:
- Check the issue tracker backlog and the open pull requests for an existing version of your bug
- If you want, you can file an issue for your issue at https://pbspro.atlassian.net, but it's not necessary
- You will have to create a pull request after you develop your bug fix
Is It a Good Idea?
Float your idea on the developer forum. Even if it's a great idea, odds are that you'll get valuable feedback about refinements. And you'll find out whether someone else is already working on something similar.
Make Issue Scope Manageable
Make sure the work you are planning is nicely bite-sized. The bug or feature may turn out to be better handled as smaller pieces. Once you have a general idea of your design, start discussion of your approach on the developer forum, and get feedback on whether the bug or feature needs to be broken down into sub-tasks. Add details to the ticket as you go along.
Make sure the code that will go into a pull request follows the guidelines for pull requests. The code must:
- Adhere to the top-level design and architecture document (the EDD) that was approved by the community
- Not destabilize the current product in any way
- Pass the current set of reviews and CI tests
- Be associated with a distinct issue ticket (meaning that the code represents a clear use case)
File New Tickets for Sub-tasks
You may need to create several smaller tasks (user stories) under the umbrella epic. Go ahead and file these issues.
Own It!
Once you have a manageable feature or bug, if you created a ticket, assign the feature or bug ticket to yourself. Now it's yours!