diff --git a/docs/github.md b/docs/github.md
index c570aa4e21..67aaffce39 100644
--- a/docs/github.md
+++ b/docs/github.md
@@ -102,7 +102,7 @@ something like this:
 ```shell
 $ # Create a new commit on top of the second-to-last commit in `your-feature`,
 $ # as reviews requested a fix there.
-$ jj new your-feature-
+$ jj new your-feature- # NOTE: the trailing hyphen is not a typo!
 $ # Address the comments by updating the code
 $ # Review the changes
 $ jj diff
@@ -112,6 +112,8 @@ $ # Push the updated branch to the remote. Jujutsu automatically makes it a forc
 $ jj git push --branch your-feature
 ```
 
+The hyphen after `your-feature` comes from [revset](https://github.com/martinvonz/jj/blob/main/docs/revsets.md) syntax.
+
 ## Using GitHub CLI
 
 GitHub CLI will have trouble finding the proper git repository path in jj repos