Skip to content

LG-7648: Create PR template#7015

Merged
eileen-nava merged 3 commits intomainfrom
em/7648-pr-template
Sep 23, 2022
Merged

LG-7648: Create PR template#7015
eileen-nava merged 3 commits intomainfrom
em/7648-pr-template

Conversation

@eileen-nava
Copy link
Contributor

🎫 Ticket

Create a PR Template for the identity-idp repo

🛠 Summary of changes

  • Added a proposed PR template to the identity-idp repo

📜 Testing Plan

Provide a checklist of steps to confirm the changes.

  • Review the PR template
  • Propose any needed changes to the template

👀 Screenshots

n/a

🚀 Notes for Deployment

n/a

@eileen-nava eileen-nava marked this pull request as ready for review September 22, 2022 17:27
@eileen-nava eileen-nava requested review from a team and svalexander September 22, 2022 19:45
@eileen-nava eileen-nava changed the title Create PR template LG-7648: Create PR template Sep 22, 2022
@svalexander
Copy link
Contributor

lgtm

Copy link
Contributor

@zachmargolis zachmargolis left a comment

Choose a reason for hiding this comment

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

LGTM

@@ -0,0 +1,33 @@
## 🎫 Ticket

Link to the relevant jira ticket.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
Link to the relevant jira ticket.
Link to the relevant Jira ticket.

It's a proper noun?

Copy link
Contributor

Choose a reason for hiding this comment

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

or drop Jira entirely, and just say "ticket"?

Suggested change
Link to the relevant jira ticket.
Link to the relevant ticket.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I'll drop it entirely.

@eileen-nava
Copy link
Contributor Author

FYSA, I am going to merge this once all checks pass. In the spirit of having a month-long trial period for this new process, I will bring up the PR template during our October 26 engineering huddle. (I don't think it's possible to put something on the agenda that far in advance, but I'll set a calendar and slack reminder to remind myself of the topic.)

@eileen-nava eileen-nava merged commit 52c19fc into main Sep 23, 2022
@eileen-nava eileen-nava deleted the em/7648-pr-template branch September 23, 2022 16:17

</details>

## 🚀 Notes for Deployment
Copy link
Contributor

Choose a reason for hiding this comment

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

Who is the intended audience of these notes? The deployer?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Yes, I was thinking of scenarios where we might need to ensure that two PRs are deployed at the same time, or that one PR is deployed first. I saw the first scenario on a previous project. I was imagining it as a possible scenario on this project, too, but let me know if you think this section isn't relevant.

Copy link
Contributor

Choose a reason for hiding this comment

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

I'd wonder how the deployer is to be made aware of these notes. Since there's nothing in the deployment guide to set the expectation that a deployer is to be reviewing each pull request for these notes, I don't think we can expect that they would.

For the scenarios you mentioned, those seem to me as being the responsibility of the code author to ensure any dependencies are merged when appropriate based on the regular deployment cadence, since those sorts of selective deployments would not be possible with the current process.

That being said, we could always revisit the steps of the deployment process itself, but I'd lean toward avoiding extra work for the deployer if we can delegate that to the individual contributors.

No need to act on it now if we'd want to reserve this kind of feedback for the planned follow-on discussion. 👍

Copy link
Contributor

Choose a reason for hiding this comment

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

I agree, I'd guess the vast majority of PRs won't have unique notes for deployment and we could potentially drop this section.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Yeah, I do agree with avoiding extra work for the deployer. Asking the deployer to review each PR’s “Notes for deployment” section would obviously make their job harder. Also, in the example I gave, the code author could use stacked PRs.

The follow-up discussion is October 26 in engineering huddle. Are you both fine with leaving the PR template as is until then?

Copy link
Contributor

Choose a reason for hiding this comment

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

The follow-up discussion is October 26 in engineering huddle. Are you both fine with leaving the PR template as is until then?

Totally fine with me 👍

@solipet solipet mentioned this pull request Sep 26, 2022
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.

6 participants