-
Notifications
You must be signed in to change notification settings - Fork 4.3k
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 "How To Get Your Pull Request Reviewed?" to developer handbook #40589
Conversation
33a710e
to
0e2882d
Compare
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This looks like a nice addition to me. I am not exactly sure of file structure so it would be best to have another review. 👍
I published a [Twitter thread](https://twitter.com/adamzielin/status/1515025299133583360) on this exact topic and it received great feedback. @poena on .org slack suggested it might be a useful addition to the developer's handbook, and so this PR adds a new page explaining how to create effective PRs.
0e2882d
to
5ef05d6
Compare
There is a similar section in the Repository Management document: It probably needs to be updated there or cross-linked between those two. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thanks @adamziel !
In general, I like the direct approach and tips of this update, although the Twitter-style approach sometimes doesn't translate too well in the handbook context (see inline discussions).
|
||
It’s the easiest way to get on others’ radar. | ||
|
||
Look up the PRs of folks listed in the previous tweet and review them. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The tweet reference here is out of context.
Great feedback @priethor, thank you! I'll adjust the writing and ping you |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This is good stuff. Just laying it out may help folks less experienced with working in the project (or in OS in general) to understand
- how to get their PR reviewed
- common pitfalls
- why their currently PR isn't getting the attention they feel it deserves.
Left some comments.
Great review, @getdave ! These small changes convey a tone that better matches the Handbook 👌 |
Co-authored-by: Héctor <[email protected]>
Co-authored-by: Héctor <[email protected]>
Co-authored-by: Héctor <[email protected]>
Co-authored-by: Dave Smith <[email protected]>
Co-authored-by: Dave Smith <[email protected]>
Co-authored-by: Dave Smith <[email protected]>
Co-authored-by: Dave Smith <[email protected]>
Co-authored-by: Dave Smith <[email protected]>
…om:WordPress/gutenberg into docs/how-to-get-your-pull-request-reviewed
docs/contributors/code/how-to-get-your-pull-request-reviewed.md
Outdated
Show resolved
Hide resolved
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thanks for addressing the feedback! 🚀
e2944e0
to
5d258da
Compare
Great work on this one 👍 |
What problem is this PR solving?
I wrote a "tutorial" to solve a common struggle – attracting a code review.
How does your PR solve it?
By adding a new handbook page. It contains the same tips as my popular Twitter thread. @carolinan on .org slack suggested it might be a useful addition to the developer's handbook, so here it is.
What feedback do you need?
How to test?
cc @atachibana @carolinan @t-hamano @talldan @gziolo @getdave @ryanwelcher @mkaz