|
| 1 | +# 2020-03-25 React Native Issue Management Meeting |
| 2 | + |
| 3 | +## Agenda: |
| 4 | +- Issue management meeting goals |
| 5 | +- Workflow enhancements |
| 6 | +- Go through Needs: Triage issues |
| 7 | +- Go through Needs: Attention issues |
| 8 | +- Discuss areas of improvement |
| 9 | +- Create action items |
| 10 | + |
| 11 | +## Issue management meeting goals |
| 12 | + |
| 13 | +Héctor shared his thoughts on issue management: |
| 14 | +- Issue triage should be a low-friction and handled by a large group of community members |
| 15 | +- Issue management meeting is where we surface improvements to the issue triage process and handle escalation paths from community triage |
| 16 | +- Folks in the weekly meeting might not necessarily do the triage themselves, instead they |
| 17 | + - Shape how issues are managed |
| 18 | + - Define what a "good issue" is, the final state we want every issue to get to, where they are ready to be looked at by someone who is interested in providing a fix (which could be one of a RN FB team member, RN core team member, or a community member who has expressed interest) |
| 19 | + |
| 20 | +Getting there: |
| 21 | +- For the next week: |
| 22 | + - Meeting members to go through issues 3x/week and triage. Intent is to dogfood the process and surface workflow improvements. |
| 23 | + - Test out the new automations and surface any additional labels or canned responses that would be helpful. |
| 24 | + - Flag any issues that were tricky to triage. |
| 25 | +- Onboard community members into the issue triage group: |
| 26 | + - Let Eli or Héctor know, and we will grant them issue management permissions. This allows them to apply labels, close, reopen issues, on the core RN repository. |
| 27 | + - React Native Wiki contains issue triage workflow to onboard new folks: https://github.com/facebook/react-native/wiki/Issues#triaging-issues |
| 28 | +- After dogfooding workflow, |
| 29 | + - Create an escalation path for issue triage group: applying a "Needs: Issue Manager Attention" label. |
| 30 | + - Meeting to switch focus to issues tagged as such. |
| 31 | + |
| 32 | +## Workflow enhancements |
| 33 | + |
| 34 | +The [label-actions](https://github.com/dessant/label-actions) GitHub App has been enabled for the core repository. It provides the following functionality: |
| 35 | + |
| 36 | +- Automatically adds a comment on issues whenever any of these labels is applied: |
| 37 | + - "Needs: Verify on Latest Version" |
| 38 | + - "Needs: Environment Info" |
| 39 | + - "Needs: Issue Template" |
| 40 | +- ...and also closes the issue when these labels are applied: |
| 41 | + - "Type: Invalid" |
| 42 | + - "Type: Question" |
| 43 | + - "Type: Docs" |
| 44 | + - "Resolution: For Stack Overflow" |
| 45 | + |
| 46 | +The full configuration file can be found in [`.github/label-actions.yml` |
| 47 | +](https://github.com/facebook/react-native/blob/master/.github/label-actions.yml). Please feel free to send a pull request with enhancements to this config. |
| 48 | + |
| 49 | +The [needs-attention](https://github.com/hramos/needs-attention) GitHub Action has been enabled, and will trigger whenever a new comment is added to an issue. The goal is to manage the "Needs: Author Feedback" label and make sure we do not lose track of issues where we asked for more information. If an issue with this label gets a new comment from the original author of the issue, this action will replace the "Needs: Author Feedback" label with a "Needs: Attention" label. This is the same process used in the `react-native-windows` repository. |
| 50 | + |
| 51 | +The workflow is configured in [`.github/workflows/needs-attention.yml`](https://github.com/facebook/react-native/blob/master/.github/workflows/needs-attention.yml), and the action itself is hosted at https://github.com/hramos/needs-attention. Pull requests that enhance this workflow are welcome. |
| 52 | + |
| 53 | +## Issue triage |
| 54 | + |
| 55 | +We went through a small number of issues with the goal of demonstrating the new label actions in use. We looked at [Issues that Need Triage](https://github.com/facebook/react-native/issues?q=is%3Aissue+is%3Aopen+label%3A%22Needs%3A+Triage+%3Amag%3A%22), as well as [Issues that Need Attention](https://github.com/facebook/react-native/issues?q=is%3Aissue+is%3Aopen+label%3A%22Needs%3A+Attention%22+). |
| 56 | + |
| 57 | +## Action Items |
| 58 | + |
| 59 | +- See "Getting there" above. Everyone to go through issues ~3x/week before our next meeting, a single page of GitHub search results should be enough (25 issues). Remove the "Needs: Triage" label for each issue you've triaged, to avoid double dipping. |
| 60 | +- Identify folks in your community who would be interested in triaging issues. |
| 61 | +- Héctor to update Wiki with latest workflow decisions: https://github.com/facebook/react-native/wiki/Issues |
| 62 | + |
| 63 | +## Attendees: |
| 64 | +- Coinbase: Ian Ownbey (@imownbey) |
| 65 | +- Expo: Charlie Cruzan (@cruzach) |
| 66 | +- SumoLogic: Jason Safaiyeh (@safaiyeh) |
| 67 | +- Facebook: Eli White (@TheSavior), Héctor Ramos (@hramos) |
0 commit comments