diff --git a/src/contributing.md b/src/contributing.md
index 1b230c74a..bad02e56b 100644
--- a/src/contributing.md
+++ b/src/contributing.md
@@ -255,7 +255,7 @@ If you encounter merge conflicts or when a reviewer asks you to perform some
 changes, your PR will get marked as `S-waiting-on-author`. When you resolve
 them, you should use `@rustbot` to mark it as `S-waiting-on-review`:
 
-    @rustbot label -S-waiting-on-author +S-waiting-on-review
+    @rustbot ready
 
 GitHub allows [closing issues using keywords][closing-keywords]. This feature
 should be used to keep the issue tracker tidy. However, it is generally preferred
diff --git a/src/rustbot.md b/src/rustbot.md
index 0959224f0..88b831697 100644
--- a/src/rustbot.md
+++ b/src/rustbot.md
@@ -44,9 +44,12 @@ the `@rustbot` command will look like this:
     @rustbot label -S-waiting-on-author +S-waiting-on-review
 
 The syntax for this command is pretty loose, so there are other variants of this
-command invocation. For more details, see [the docs page about labeling][labeling].
+command invocation. There are also some shortcuts to update labels,
+for instance `@rustbot ready` will do the same thing with above command.
+For more details, see [the docs page about labeling][labeling] and [shortcuts][shortcuts].
 
 [labeling]: https://forge.rust-lang.org/triagebot/labeling.html
+[shortcuts]: https://forge.rust-lang.org/triagebot/shortcuts.html
 
 ## Other commands
 
diff --git a/src/walkthrough.md b/src/walkthrough.md
index b8311b19a..704c1be0d 100644
--- a/src/walkthrough.md
+++ b/src/walkthrough.md
@@ -186,10 +186,19 @@ request that reviewer by leaving a comment on the thread with `r?
 @reviewer-github-id` (e.g. `r? @eddyb`). If you don't know who to request,
 don't request anyone; the bot will assign someone automatically based on which files you changed.
 
-The reviewer may request changes before they approve your PR. Feel free to ask
-questions or discuss things you don't understand or disagree with. However,
+The reviewer may request changes before they approve your PR, they may mark the PR with label 
+"S-waiting-on-author" after leaving comments, this means that the PR is blocked on you to make 
+some requested changes. When you finished iterating on the changes, you can mark the PR as 
+`S-waiting-on-review` again by leaving a comment with `@rustbot ready`, this will remove the 
+`S-waiting-on-author` label and add the `S-waiting-on-review` label.
+
+Feel free to ask questions or discuss things you don't understand or disagree with. However,
 recognize that the PR won't be merged unless someone on the Rust team approves
-it.
+it. If a reviewer leave a comment like `r=me after fixing ...`, that means they approve the PR and 
+you can merge it with comment with `@bors r=reviwer-github-id`(e.g. `@bors r=eddyb`) to merge it 
+after fixing trivial issues. Note that `r=someone` requires permission and bors could say 
+something like "🔑 Insufficient privileges..." when commenting `r=someone`. In that case, 
+you have to ask the reviewer to revisit your PR.
 
 When your reviewer approves the PR, it will go into a queue for yet another bot
 called `@bors`. `@bors` manages the CI build/merge queue. When your PR reaches