Skip to content

[ci] shorten Pull Request template#57752

Merged
matthewdeng merged 3 commits intoray-project:masterfrom
matthewdeng:pr-template-fix
Oct 16, 2025
Merged

[ci] shorten Pull Request template#57752
matthewdeng merged 3 commits intoray-project:masterfrom
matthewdeng:pr-template-fix

Conversation

@matthewdeng
Copy link
Copy Markdown
Contributor

@matthewdeng matthewdeng commented Oct 15, 2025

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: Matthew Deng <matthew.j.deng@gmail.com>
@matthewdeng matthewdeng requested review from cszhu and edoakes October 15, 2025 20:32
Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

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

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.

Comment on lines +13 to +15
## 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. -->
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

medium

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.

Suggested change
## 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 -->

Copy link
Copy Markdown
Collaborator

@cszhu cszhu left a comment

Choose a reason for hiding this comment

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

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.

@@ -10,36 +10,6 @@

<!-- Link related issues: "Fixes #1234", "Closes #1234", or "Related to #1234" -->
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

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?

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

we can even say "edit or replace the text in the template" or something to make it very clear

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

sounds minor, but I probably spend like 30min a week doing this 😮‍💨

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

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.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

love it!

@ray-gardener ray-gardener bot added docs An issue or change related to documentation core Issues that should be addressed in Ray Core devprod labels Oct 16, 2025
Signed-off-by: Matthew Deng <matthew.j.deng@gmail.com>
@matthewdeng matthewdeng enabled auto-merge (squash) October 16, 2025 18:58
@github-actions github-actions bot added the go add ONLY when ready to merge, run all tests label Oct 16, 2025
@matthewdeng matthewdeng merged commit 068910f into ray-project:master Oct 16, 2025
8 checks passed
justinyeh1995 pushed a commit to justinyeh1995/ray that referenced this pull request Oct 20, 2025
## 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>
xinyuangui2 pushed a commit to xinyuangui2/ray that referenced this pull request Oct 22, 2025
## 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>
elliot-barn pushed a commit that referenced this pull request Oct 23, 2025
## 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>
landscapepainter pushed a commit to landscapepainter/ray that referenced this pull request Nov 17, 2025
## 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>
Aydin-ab pushed a commit to Aydin-ab/ray-aydin that referenced this pull request Nov 19, 2025
## 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>
Future-Outlier pushed a commit to Future-Outlier/ray that referenced this pull request Dec 7, 2025
## 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>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

core Issues that should be addressed in Ray Core devprod docs An issue or change related to documentation go add ONLY when ready to merge, run all tests

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants