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

add a Pull Request template #1684

Closed
wants to merge 1 commit into from
Closed

add a Pull Request template #1684

wants to merge 1 commit into from

Conversation

zeke
Copy link
Member

@zeke zeke commented May 22, 2024

This PR adds a pull request template to help remind contributors to describe the changes they're making, and include tests and documentation as appropriate.

This will show up as the default text in the textarea when opening a PR. Authors can keep it and fill it out, or delete it and start fresh.

@mattt
Copy link
Member

mattt commented May 22, 2024

@zeke I haven't found our volume or quality of PRs to cause any problems so far. PR templates can be nice for enforcing rules and process, but I'm not sure we need something like that right now.

@zeke
Copy link
Member Author

zeke commented May 22, 2024

I disagree. Every PR we land that adds a feature without accompanying docs becomes a liability.

I think we'll get better and more accurate docs if they are contributed by the authors of the features, at the time of implementation. Furthermore, writing docs gives authors an extra opportunity to consider the shape of the feature they're proposing, test it, and evaluate whether it actually works and makes sense.

@zeke zeke requested a review from a team May 22, 2024 20:41
@erbridge
Copy link
Member

erbridge commented Jun 7, 2024

I agree with the sentiment of a pull request template, but I don't think this one has enough guidance or structure as to what to do with it. By my naive reading, the comment seems to apply to the check list, but in a way that doesn't make sense (am I supposed to write tests and docs that describe the pull request?).

@mattt
Copy link
Member

mattt commented Jun 11, 2024

I agree with @erbridge. I think a pull request template can be helpful, but I don't think this particular implementation would add much.

Happy to revisit this once we've identified a specific need for PR template, or have more consensus around what kind of process we want to have for this project.

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.

None yet

3 participants