[ci] shorten Pull Request template#57752
Conversation
Signed-off-by: Matthew Deng <matthew.j.deng@gmail.com>
There was a problem hiding this comment.
Code Review
This pull request aims to shorten the pull request template. It updates the contribution guide link, removes the lengthy 'Types of change' and 'Checklist' sections, and renames 'Additional context' to 'Additional information'. The changes make the template more concise. I have one suggestion to retain the explicit check for breaking changes, as this is critical information that might be overlooked in a generic section.
.github/PULL_REQUEST_TEMPLATE.md
Outdated
| ## Additional information | ||
|
|
||
| - [ ] Bug fix 🐛 | ||
| - [ ] New feature ✨ | ||
| - [ ] Enhancement 🚀 | ||
| - [ ] Code refactoring 🔧 | ||
| - [ ] Documentation update 📖 | ||
| - [ ] Chore 🧹 | ||
| - [ ] Style 🎨 | ||
|
|
||
| ## Checklist | ||
|
|
||
| **Does this PR introduce breaking changes?** | ||
| - [ ] Yes ⚠️ | ||
| - [ ] No | ||
| <!-- If yes, describe what breaks and how users should migrate --> | ||
|
|
||
| **Testing:** | ||
| - [ ] Added/updated tests for my changes | ||
| - [ ] Tested the changes manually | ||
| - [ ] This PR is not tested ❌ _(please explain why)_ | ||
|
|
||
| **Code Quality:** | ||
| - [ ] Signed off every commit (`git commit -s`) | ||
| - [ ] Ran pre-commit hooks ([setup guide](https://docs.ray.io/en/latest/ray-contribute/getting-involved.html#lint-and-formatting)) | ||
|
|
||
| **Documentation:** | ||
| - [ ] Updated documentation (if applicable) ([contribution guide](https://docs.ray.io/en/latest/ray-contribute/docs.html)) | ||
| - [ ] Added new APIs to `doc/source/` (if applicable) | ||
|
|
||
| ## Additional context | ||
|
|
||
| <!-- Optional: Add screenshots, examples, performance impact, breaking change details --> | ||
| <!-- Optional: Add implementation details, API changes, usage examples, screenshots, etc. --> |
There was a problem hiding this comment.
Simplifying the template is a great idea. However, removing the explicit check for breaking changes might lead to contributors forgetting to document them. This is a critical piece of information for reviewers and users. I'd suggest re-adding just that part of the checklist to ensure it's not missed. The 'Additional information' section is quite generic and might not be a strong enough prompt.
| ## Additional information | |
| - [ ] Bug fix 🐛 | |
| - [ ] New feature ✨ | |
| - [ ] Enhancement 🚀 | |
| - [ ] Code refactoring 🔧 | |
| - [ ] Documentation update 📖 | |
| - [ ] Chore 🧹 | |
| - [ ] Style 🎨 | |
| ## Checklist | |
| **Does this PR introduce breaking changes?** | |
| - [ ] Yes ⚠️ | |
| - [ ] No | |
| <!-- If yes, describe what breaks and how users should migrate --> | |
| **Testing:** | |
| - [ ] Added/updated tests for my changes | |
| - [ ] Tested the changes manually | |
| - [ ] This PR is not tested ❌ _(please explain why)_ | |
| **Code Quality:** | |
| - [ ] Signed off every commit (`git commit -s`) | |
| - [ ] Ran pre-commit hooks ([setup guide](https://docs.ray.io/en/latest/ray-contribute/getting-involved.html#lint-and-formatting)) | |
| **Documentation:** | |
| - [ ] Updated documentation (if applicable) ([contribution guide](https://docs.ray.io/en/latest/ray-contribute/docs.html)) | |
| - [ ] Added new APIs to `doc/source/` (if applicable) | |
| ## Additional context | |
| <!-- Optional: Add screenshots, examples, performance impact, breaking change details --> | |
| <!-- Optional: Add implementation details, API changes, usage examples, screenshots, etc. --> | |
| ## Additional information | |
| <!-- Optional: Add implementation details, API changes, usage examples, screenshots, etc. --> | |
| --- | |
| **Does this PR introduce breaking changes?** | |
| - [ ] Yes ⚠️ | |
| - [ ] No | |
| <!-- If yes, describe what breaks and how users should migrate --> |
cszhu
left a comment
There was a problem hiding this comment.
I kind of miss the "checklist for what changes" this is for (i.e. bug fix, new feature etc) but if the user is following the PR guidelines, then the commit should include that in the beginning with feat: or style:, so I guess it's fine. I can understand the desire for a simpler template too.
.github/PULL_REQUEST_TEMPLATE.md
Outdated
| @@ -10,36 +10,6 @@ | |||
|
|
|||
| <!-- Link related issues: "Fixes #1234", "Closes #1234", or "Related to #1234" --> | |||
There was a problem hiding this comment.
it'll make committers' lives easier if we make these regular text instead of comments
currently, people leave the comments in the description and then we have to manually go through and trim them out when committing the PR
if we make them regular text, then it'll be clear that they should overwrite/delete the prompts.
WDYT?
There was a problem hiding this comment.
we can even say "edit or replace the text in the template" or something to make it very clear
There was a problem hiding this comment.
sounds minor, but I probably spend like 30min a week doing this 😮💨
There was a problem hiding this comment.
I completely understand. PTAL at the updated template. Looks like this now:
Thank you for contributing to Ray! 🚀
Please review the Ray Contribution Guide before opening a pull request.
⚠️ Remove these instructions before submitting your PR.
💡 Tip: Mark as draft if you want early feedback, or ready for review when it's complete.
Description
Briefly describe what this PR accomplishes and why it's needed.
Related issues
Link related issues: "Fixes #1234", "Closes #1234", or "Related to #1234".
Additional information
Optional: Add implementation details, API changes, usage examples, screenshots, etc.
## Description Shortening the template per @edoakes' feedback. ## Related issues Follow-up to ray-project#57193. ## Additional information Made the following changes: 1. Removed `Types of change` and `Checklist`. 2. Updated contribution guide to point to Ray Docs. 3. Renamed `Additional context` to `Additional information` to be more encompassing. --------- Signed-off-by: Matthew Deng <matthew.j.deng@gmail.com>
## Description Shortening the template per @edoakes' feedback. ## Related issues Follow-up to ray-project#57193. ## Additional information Made the following changes: 1. Removed `Types of change` and `Checklist`. 2. Updated contribution guide to point to Ray Docs. 3. Renamed `Additional context` to `Additional information` to be more encompassing. --------- Signed-off-by: Matthew Deng <matthew.j.deng@gmail.com> Signed-off-by: xgui <xgui@anyscale.com>
## Description Shortening the template per @edoakes' feedback. ## Related issues Follow-up to #57193. ## Additional information Made the following changes: 1. Removed `Types of change` and `Checklist`. 2. Updated contribution guide to point to Ray Docs. 3. Renamed `Additional context` to `Additional information` to be more encompassing. --------- Signed-off-by: Matthew Deng <matthew.j.deng@gmail.com> Signed-off-by: elliot-barn <elliot.barnwell@anyscale.com>
## Description Shortening the template per @edoakes' feedback. ## Related issues Follow-up to ray-project#57193. ## Additional information Made the following changes: 1. Removed `Types of change` and `Checklist`. 2. Updated contribution guide to point to Ray Docs. 3. Renamed `Additional context` to `Additional information` to be more encompassing. --------- Signed-off-by: Matthew Deng <matthew.j.deng@gmail.com>
## Description Shortening the template per @edoakes' feedback. ## Related issues Follow-up to ray-project#57193. ## Additional information Made the following changes: 1. Removed `Types of change` and `Checklist`. 2. Updated contribution guide to point to Ray Docs. 3. Renamed `Additional context` to `Additional information` to be more encompassing. --------- Signed-off-by: Matthew Deng <matthew.j.deng@gmail.com> Signed-off-by: Aydin Abiar <aydin@anyscale.com>
## Description Shortening the template per @edoakes' feedback. ## Related issues Follow-up to ray-project#57193. ## Additional information Made the following changes: 1. Removed `Types of change` and `Checklist`. 2. Updated contribution guide to point to Ray Docs. 3. Renamed `Additional context` to `Additional information` to be more encompassing. --------- Signed-off-by: Matthew Deng <matthew.j.deng@gmail.com> Signed-off-by: Future-Outlier <eric901201@gmail.com>
Description
Shortening the template per @edoakes' feedback.
Related issues
Follow-up to #57193.
Additional information
Made the following changes:
Types of changeandChecklist.Additional contexttoAdditional informationto be more encompassing.