Skip to content
This repository has been archived by the owner on Dec 21, 2023. It is now read-only.

Update PR template for monorepo #602

Merged
merged 1 commit into from
Dec 16, 2021
Merged

Update PR template for monorepo #602

merged 1 commit into from
Dec 16, 2021

Conversation

axeldelafosse
Copy link
Contributor

Why

Wanted to simplify the template for this monorepo, I think we don't need the "Impact" section.

How

Took the template from Expo https://github.com/expo/expo/blob/master/.github/PULL_REQUEST_TEMPLATE

@vercel
Copy link

vercel bot commented Dec 15, 2021

This pull request is being automatically deployed with Vercel (learn more).
To see the status of your deployment, click below or on the icon next to each commit.

🔍 Inspect: https://vercel.com/showtime/showtime/5bDK5XNXSFzQ8h5zSax7gv7m5vfR
✅ Preview: https://showtime-git-pr-template-showtime.vercel.app

Copy link
Contributor

@TatisLois TatisLois left a comment

Choose a reason for hiding this comment

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

Left a comment but leaving it open to whatever the consensus ends up!

@@ -0,0 +1,17 @@
# Why
Copy link
Contributor

Choose a reason for hiding this comment

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

If the consensus is to remove the impact section then I’m for it but I’ll offer a counter point of view!

For the monorepo I think the impact section is useful. It’s not always clear if a change will affect mobile, web, design system or another app/package since they are interwoven in different ways.

Further highlighted by the fact that we don’t have any automated tests to keep us somewhat guarded.

I also think it’ll help reviewers know how and where to test a PR.

+1 on your slack comment about omitting sections that don’t apply. We can use our best judgment!

Copy link
Collaborator

Choose a reason for hiding this comment

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

Looks good. Also, we can add a checklist. web, ios, android, dark mode. It can also be a part of linear issue though.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

It’s not always clear if a change will affect mobile, web, design system or another app/package since they are interwoven in different ways.

This should be highlighted in the "Why" imo

I also think it’ll help reviewers know how and where to test a PR.

And this should be in the "Test Plan"

It can also be a part of linear issue though.

Yeah good idea! It won't always be a universal change (at least for now) so let's keep it simple for everyone.

Copy link
Contributor

Choose a reason for hiding this comment

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

This should be highlighted in the "Why" imo

actually this is exactly the purpose of the “impact” section :D

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Haha yeah I know, I meant to say that a good "Why" section should highlight this.

Copy link
Contributor

Choose a reason for hiding this comment

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

Not sure something like "Open PRs that use components XYZ will need to be rebased before merging" really fit in "Why" though

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Agreed. Feel free to add an "Impact" section when there is a comment like this! I just feel like it's not going to happen much at our stage and I want to tend towards simplicity.

Copy link
Contributor

@fontanierh fontanierh Dec 16, 2021

Choose a reason for hiding this comment

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

imho the goal of having it in the template is to force the person opening the PR to think about it. If it's not in the template, then it's very easy to forget about the potential impact of your PR

@axeldelafosse
Copy link
Contributor Author

Here is my proposal: let's keep it simple and see how our team is using this template. Feel free to add (or remove) any section. We will be able to revisit this template later on based on our usage.

@axeldelafosse axeldelafosse reopened this Dec 16, 2021
@axeldelafosse axeldelafosse merged commit 7b1f0a5 into staging Dec 16, 2021
@intergalacticspacehighway intergalacticspacehighway deleted the pr-template branch December 16, 2021 10:13
@TatisLois
Copy link
Contributor

Here is my proposal: let's keep it simple and see how our team is using this template. Feel free to add (or remove) any section. We will be able to revisit this template later on based on our usage.

Here is my proposal: let's keep it simple and see how our team is using this template. Feel free to add (or remove) any section. We will be able to revisit this template later on based on our usage.

Sorry if I misunderstood but why merge the changes if we are taking a wait and see approach based on usage? Why not have left it and remove it.

@axeldelafosse
Copy link
Contributor Author

Feel free to add it back but my goal is to avoid adding more complexity to the process. I think we should default to simplicity.

@TatisLois
Copy link
Contributor

Feel free to add it back but my goal is to avoid adding more complexity to the process. I think we should default to simplicity.

Nah, that would be more work than it's worth haha. What's done is done 🙂

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants