Skip to content

Update pull request template#1162

Merged
mcmire merged 4 commits intomainfrom
update-pull-request-template
Apr 5, 2023
Merged

Update pull request template#1162
mcmire merged 4 commits intomainfrom
update-pull-request-template

Conversation

@mcmire
Copy link
Contributor

@mcmire mcmire commented Mar 31, 2023

Description

The pull request template is a bit confusing and is prone to creating extra noise.

  • After the line "PR Title", the reader is instructed to fill out a description of changes, and then there is the line "Description". If "PR Title" and "Description" are section headers, one would think a description would be placed within the "Description" section, not the "PR Title" section.
  • The "Description" section holds an example, but most PRs I've seen do not clear this section out appropriately, but leave unfilled sections untouched.
  • This PR template is inconsistent with the one we use for the module template. While of course this repo is shared among multiple teams, we should strive to keep it somewhat more consistent.

Changes

  • CHANGED: Update the pull request template.

Checklist

  • I've updated the test suite for new or updated code as appropriate
  • I've updated documentation for new or updated code as appropriate (note: this will usually be JSDoc)
  • I've highlighted breaking changes using the "BREAKING" category above

The pull request template is a bit confusing and is prone to creating
extra noise.

* After the line "PR Title", the reader is instructed to fill out a
  description of changes, and then there is the line "Description". If
  "PR Title" and "Description" are section headers, one would think a
  description would be placed within the "Description" section, not the
  "PR Title" section.
* The "Description" section holds an example, but most PRs I've seen do
  not clear this section out appropriately, but leave unfilled sections
  untouched.
* This PR template is inconsistent with the one we use for the module
  template. While of course this repo is shared among multiple teams, we
  should strive to keep it somewhat more consistent.
@mcmire mcmire requested a review from a team as a code owner March 31, 2023 22:01
Copy link
Member

@Gudahtt Gudahtt left a comment

Choose a reason for hiding this comment

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

LGTM! Thanks for updating this, I've been meaning to do this for some time

@BelfordZ
Copy link
Contributor

BelfordZ commented Apr 5, 2023

looks good. Just wondering if we should put this in the module template ?

@mcmire
Copy link
Contributor Author

mcmire commented Apr 5, 2023

@BelfordZ Yeah, that'd probably be good. I'll make a PR over there too.

@mcmire mcmire merged commit a3b454e into main Apr 5, 2023
@mcmire mcmire deleted the update-pull-request-template branch April 5, 2023 18:44
MajorLift pushed a commit that referenced this pull request Oct 11, 2023
The pull request template is a bit confusing and is prone to creating
extra noise.

* After the line "PR Title", the reader is instructed to fill out a
  description of changes, and then there is the line "Description". If
  "PR Title" and "Description" are section headers, one would think a
  description would be placed within the "Description" section, not the
  "PR Title" section.
* The "Description" section holds an example, but most PRs I've seen do
  not clear this section out appropriately, but leave unfilled sections
  untouched.
* This PR template is inconsistent with the one we use for the module
  template. While of course this repo is shared among multiple teams, we
  should strive to keep it somewhat more consistent.
MajorLift pushed a commit that referenced this pull request Oct 11, 2023
The pull request template is a bit confusing and is prone to creating
extra noise.

* After the line "PR Title", the reader is instructed to fill out a
  description of changes, and then there is the line "Description". If
  "PR Title" and "Description" are section headers, one would think a
  description would be placed within the "Description" section, not the
  "PR Title" section.
* The "Description" section holds an example, but most PRs I've seen do
  not clear this section out appropriately, but leave unfilled sections
  untouched.
* This PR template is inconsistent with the one we use for the module
  template. While of course this repo is shared among multiple teams, we
  should strive to keep it somewhat more consistent.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants