woocommerce/.github/ISSUE_TEMPLATE/new-prr-template.yml

96 lines
4.6 KiB
YAML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

name: 🚧 Point release request
description: Request handling one or more pull requests(s) as point release request(s).
title: "[PRR]: "
labels: ["point release request"]
body:
- type: markdown
attributes:
value: |
Use this template to request changes to be included as part of a point release.
**The request will be reviewed** and accepted or denied:
* If accepted, please test your changes in against the release branch and merge.
* If rejected, please change the base against `trunk` and merge it.
In either case you are responsible for managing the pull request as usual (provide a description, assign reviewers, ensure that CI jobs pass...)
- type: input
id: release-number
attributes:
label: "Which release does this request apply to?"
description: "Format: X.Y (Major.Minor)"
placeholder: "9.2"
validations:
required: true
- type: textarea
id: pr-urls
attributes:
label: "Which PR needs to be included? (please do not enter multiple PRs)"
description: "Pull request URL against the release branch"
placeholder: |
https://github.com/woocommerce/woocommerce/pull/1234
validations:
required: true
- type: textarea
id: why-needed
attributes:
label: "Why does this PR need a point release?"
placeholder: "This is a revert of ... which introduced a bug that causes ..."
validations:
required: true
- type: textarea
attributes:
id: consequence-if-not-included
label: "What is the consequence if this fix not being included in the point release (if any)? e.g. number of users affected and how they are affected"
placeholder: "The ... flow will be broken for ... users"
validations:
required: true
- type: textarea
id: plan-if-defects-discovered
attributes:
label: "What is the plan should defects to be discovered in these PR after the point release?"
placeholder: "Reverting this PR and ... would be enough"
validations:
required: true
- type: textarea
id: how-to-communicate
attributes:
label: "How should this change be communicated in the release post on the public developer blog: cc @woocommerce/developer-advocacy"
description: "See the blog at [https://developer.woo.com/blog/](https://developer.woo.com/blog/)"
placeholder: "There is no need to add new communication to the already planned one."
validations:
required: true
- type: textarea
id: workaround
attributes:
label: "Is there a workaround to the issue? If yes, how should we communicate it on the (public developer blog)[https://developer.woo.com/blog/]?"
placeholder: "Use the ... flow instead"
validations:
required: true
- type: textarea
id: who-to-ask
attributes:
label: "If youre not available and we have questions about this request, is there another person(s) and/or a team that we can ping?"
placeholder: "@person or anyone from the ... team"
validations:
required: true
- type: markdown
attributes:
value: |
## Escape Analysis
For the sake of expediting this request, the details below can be completed at a later time should you so choose.
However, the Escape Analysis section is **required** for any accepted Point Release Request.
In this section:
* Think about how the bug escaped your team.
* Write down ideas on how you could prevent this bug for example, by writing automated tests, creating a new process, or updating documentation.
* Make a plan with your team to implement the changes proposed above in order to catch the bug earlier next time and add the related tasks to your backlog.
* Please, add a separate comment that includes the details for the Escape Analysis. Together with this Escape Analysis, please make sure to include an actionable item that covers the gap exposed by this analysis. It could be a GitHub issue, the reference of a new item to discuss in a team meeting, etc. Anything that prevents this analysis from getting lost in P2 will be useful.
- type: checkboxes
id: escape-analysis-completed
attributes:
label: "Acknowledgement"
options:
- label: "I understand that I need to write an incident report (aka Escape Analysis) as a comment on this post. This is required for the request to be accepted."
required: true
- label: "I understand that I need to create an issue as a result of the Escape Analysis and reference it in a comment on this post. This can be done at a later time, but it is required for this request to be closed."
required: true