Thanks to visit codestin.com
Credit goes to github.com

Skip to content

DOC: Update CONTRIBUTING.rst #28158

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

Merged
merged 4 commits into from
Jun 20, 2025
Merged

DOC: Update CONTRIBUTING.rst #28158

merged 4 commits into from
Jun 20, 2025

Conversation

speco29
Copy link
Contributor

@speco29 speco29 commented Jan 15, 2025

fixes #19778
Updating the contibution section so that contributors avoid doing mkstakes while asking questions, instead they focus on doing contribution and work on project right after.

fixes numpy#19778
Updating the contibution section so that contributors avoid doing mkstakes while asking questions, instead they focus on doing contribution and work on project right after.
CONTRIBUTING.rst Outdated
@@ -8,7 +8,8 @@ help us grow.

Pull requests (PRs) are always welcome, but making a PR is just the
start. Please respond to comments and requests for changes to help
move the process forward. Please follow our
move the process forward. If you are new to contribution, avoid making questions like - "Can I work on this issue or please assign this to me" instead do your contribution and narrate - "I have done this, review it or Here's my work". It would be easy to help and contribute.
Copy link
Member

Choose a reason for hiding this comment

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

Please break the long line, <= 88 chars is fine.

@charris charris changed the title Update CONTRIBUTING.rst DOC: Update CONTRIBUTING.rst Jan 15, 2025
@melissawm
Copy link
Member

Hi @speco29 - would you like to finish this up? Thanks!

Shortened the length of the sentence.
@speco29
Copy link
Contributor Author

speco29 commented Jun 13, 2025

Hi @speco29 - would you like to finish this up? Thanks!

Yah, sure.
I just updated it, please review it. Thanks!

CONTRIBUTING.rst Outdated
@@ -8,7 +8,8 @@ help us grow.

Pull requests (PRs) are always welcome, but making a PR is just the
start. Please respond to comments and requests for changes to help
move the process forward. Please follow our
Skip asking for assignments—just contribute and say, "Here's my work, review it." It makes collaboration and support much easier.
Copy link
Member

Choose a reason for hiding this comment

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

I'm sorry to be so nitpicky but I think it's important - a beginner may not understand what "assignments" mean in this context, and I think we can work on the tone of the review request. I'd say something like

Suggested change
Skip asking for assignments—just contribute and say, "Here's my work, review it." It makes collaboration and support much easier.
Skip asking for an issue to be assigned to you on GitHub—send in your PR, explain what you did and ask for a review. It makes collaboration and support much easier.

Again this is nitpicky but since we're looking to guide people I'd rather be more careful with the wording here. Thanks for following up!

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'm sorry to be so nitpicky but I think it's important - a beginner may not understand what "assignments" mean in this context, and I think we can work on the tone of the review request. I'd say something like

Again this is nitpicky but since we're looking to guide people I'd rather be more careful with the wording here. Thanks for following up!

No problem at all;)
You are right, I will update it. Thanks for the review.

Copy link
Member

@melissawm melissawm left a comment

Choose a reason for hiding this comment

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

Thanks for sticking with it, @speco29 !

@melissawm melissawm merged commit 7c91551 into numpy:main Jun 20, 2025
76 of 77 checks passed
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.

DOC: Tighten up first-time contributor suggestion on README.md and dev.index.rst
3 participants