mirror of
https://github.com/zulip/zulip.git
synced 2025-11-05 22:43:42 +00:00
doc: Fix typos in code reviewing doc.
Made some spelling and grammatical changes.
This commit is contained in:
@@ -11,7 +11,7 @@ outside of the handful of people who do a ton of reviews -- and
|
|||||||
`@`-mention them with something like "`@person`, would you review
|
`@`-mention them with something like "`@person`, would you review
|
||||||
this?". Good choices include
|
this?". Good choices include
|
||||||
|
|
||||||
- someone based in your timezone or a nearby timezone
|
- someone based in your time zone or a nearby time zone
|
||||||
- people working on similar things, or in a loosely related area
|
- people working on similar things, or in a loosely related area
|
||||||
|
|
||||||
Alternatively, posting a message in
|
Alternatively, posting a message in
|
||||||
@@ -20,7 +20,7 @@ development community server](https://zulip.com/development-community/), would
|
|||||||
help in reaching out to a wider group of reviewers. Either way, please be
|
help in reaching out to a wider group of reviewers. Either way, please be
|
||||||
patient and mindful of the fact that it isn't possible to provide a
|
patient and mindful of the fact that it isn't possible to provide a
|
||||||
quick reply always, but that the reviewer would get to it sooner or later.
|
quick reply always, but that the reviewer would get to it sooner or later.
|
||||||
Lastly, ensuring the your PR passes CI and is organized into coherent
|
Lastly, ensuring that your PR passes CI and is organized into coherent
|
||||||
commits would help save reviewers time, which could otherwise be used
|
commits would help save reviewers time, which could otherwise be used
|
||||||
to dive right into reviewing the PR's core functionality.
|
to dive right into reviewing the PR's core functionality.
|
||||||
|
|
||||||
@@ -98,7 +98,7 @@ just saying you're busy and when you'll have time to look harder -- is
|
|||||||
still really valuable for the author and for anyone else who might
|
still really valuable for the author and for anyone else who might
|
||||||
review the PR.
|
review the PR.
|
||||||
|
|
||||||
People in the Zulip project live and work in many timezones, and code
|
People in the Zulip project live and work in many time zones, and code
|
||||||
reviewers also need focused chunks of time to write code and do other
|
reviewers also need focused chunks of time to write code and do other
|
||||||
things, so an immediate reply isn't always possible. But a good
|
things, so an immediate reply isn't always possible. But a good
|
||||||
benchmark is to try to always reply **within one workday**, at least
|
benchmark is to try to always reply **within one workday**, at least
|
||||||
@@ -170,8 +170,8 @@ sooner is better.
|
|||||||
conflicts) if there are still user experience issues under
|
conflicts) if there are still user experience issues under
|
||||||
discussion for the feature itself.
|
discussion for the feature itself.
|
||||||
|
|
||||||
- _Completeness._ For refactorings, verify that the changes are
|
- _Completeness._ When reviewing a refactor, verify that the changes are
|
||||||
complete. Usually one can check that efficiently using `git grep`,
|
complete. Usually, one can check that efficiently using `git grep`,
|
||||||
and it's worth it, as we very frequently find issues by doing so.
|
and it's worth it, as we very frequently find issues by doing so.
|
||||||
|
|
||||||
- _Documentation updates._ If this changes how something works, does it
|
- _Documentation updates._ If this changes how something works, does it
|
||||||
|
|||||||
Reference in New Issue
Block a user