diff --git a/pages/common/jj-diff.md b/pages/common/jj-diff.md
index fb7738f308..f11d167f16 100644
--- a/pages/common/jj-diff.md
+++ b/pages/common/jj-diff.md
@@ -7,7 +7,7 @@
 
 `jj diff`
 
-- Show changes of given revsets:
+- Show changes of given revsets (e.g. `B::D`, `A..D`, `B|C|D`, etc.):
 
 `jj diff {{[-r|--revisions]}} {{revsets}}`
 
diff --git a/pages/common/jj-log.md b/pages/common/jj-log.md
index 857839ea2b..33ea65c0da 100644
--- a/pages/common/jj-log.md
+++ b/pages/common/jj-log.md
@@ -7,6 +7,6 @@
 
 `jj log`
 
-- Show only given revsets:
+- Show only given revsets (e.g. `B::D`, `A..D`, `B|C|D`, etc.):
 
 `jj log {{[-r|--revisions]}} {{revsets}}`
diff --git a/pages/common/jj.md b/pages/common/jj.md
index 59fb488f0e..7474c21a65 100644
--- a/pages/common/jj.md
+++ b/pages/common/jj.md
@@ -4,11 +4,11 @@
 > Some subcommands such as `log`, `desc`, `new`, `git`, etc. have their own usage documentation.
 > More information: <https://jj-vcs.github.io/jj/latest/cli-reference/>.
 
-- Update description of the given revision(s):
+- Update description of the revisions specified by given revsets (e.g. `B::D`, `A..D`, `B|C|D`, etc.):
 
 `jj describe {{[-r|--revision]}} {{revsets}}`
 
-- Create a new commit/revision on top of the given revision(s):
+- Create a new commit/revision on top of the revisions specified by the given revsets:
 
 `jj new {{revsets}}`