Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Chore: add prerequisites checklist to PR template #12790

Merged
merged 3 commits into from Jan 16, 2020
Merged

Conversation

kaicataldo
Copy link
Member

What is the purpose of this pull request? (put an "X" next to item)

[ ] Documentation update
[ ] Bug fix (template)
[ ] New rule (template)
[ ] Changes an existing rule (template)
[ ] Add autofixing to a rule
[ ] Add a CLI option
[ ] Add something to the core
[X] Other, please explain:

Updating our PR template text

What changes did you make? (Give an overview)

I've been noticing that we're getting an increasing number of PRs that do not have a corresponding accepted issue. While we have a process in place to handle this, I can imagine it doesn't feel great as the PR author to make a PR that then doesn't get merged. This is a proposed solution to hopefully make it clearer to PR authors what the team's process is and what expectations we have of them as well as what they can expect from us.

Is there anything you'd like reviewers to focus on?
Thoughts on this solution? Do you think something else might work better?

@eslint-deprecated eslint-deprecated bot added the triage An ESLint team member will look at this issue soon label Jan 14, 2020
@kaicataldo kaicataldo changed the title Update pr template Chore: add prerequisites checklist to PR template Jan 14, 2020
@kaicataldo kaicataldo added chore This change is not user-facing evaluating The team will evaluate this issue to decide whether it meets the criteria for inclusion and removed triage An ESLint team member will look at this issue soon labels Jan 14, 2020
ESLint adheres to the [JS Foundation Code of Conduct](https://js.foundation/community/code-of-conduct).
-->

**What is the purpose of this pull request? (put an "X" next to item)**
#### Prerequisites checklist
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

These were changed because markdownlint now warns on using emphasized text as headers (MD036/no-emphasis-as-heading/no-emphasis-as-header). This should look the same to the end user.

Copy link
Member

@platinumazure platinumazure left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just a couple of thoughts around the team consensus checklist item, otherwise looks great to me. Thanks for putting this together!

#### Prerequisites checklist

- [ ] I have read the [contributing guidelines](https://raw.githubusercontent.com/eslint/eslint/master/templates/bug-report.md).
- [ ] The team has reached consensus on the changes proposed in this pull request. If not, I understand that the process will begin with this pull request and won't be merged until it has been accepted.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not critical, but could this say "I understand that the [evaluation/consensus] process will begin with this pull request and won't be merged until it has been accepted"?

Also, I think we're conflating "team has reached consensus" with "issue is accepted". This is correct from the perspective of our process, but a newcomer may not understand that intuitively. It would be great if we could use the same verb phrase throughout the sentence, to the extent it is feasible.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good idea! Updated - please let me know what you think.

Copy link
Member

@platinumazure platinumazure left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks great, thanks!

@kaicataldo kaicataldo removed the evaluating The team will evaluate this issue to decide whether it meets the criteria for inclusion label Jan 16, 2020
@kaicataldo
Copy link
Member Author

Removing the evaluating label since this is a chore.

@kaicataldo kaicataldo merged commit 561b6d4 into master Jan 16, 2020
@kaicataldo kaicataldo deleted the update-pr-template branch January 16, 2020 21:45
montmanu pushed a commit to montmanu/eslint that referenced this pull request Mar 4, 2020
* Chore: add prerequisites checklist to PR template

* Add friendly message at top

* Address feedback
@eslint-deprecated eslint-deprecated bot locked and limited conversation to collaborators Jul 16, 2020
@eslint-deprecated eslint-deprecated bot added the archived due to age This issue has been archived; please open a new issue for any further discussion label Jul 16, 2020
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
archived due to age This issue has been archived; please open a new issue for any further discussion chore This change is not user-facing
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

3 participants