diff --git a/docs/publishing/github-pages.qmd b/docs/publishing/github-pages.qmd
index abe405c500..0ec19e4792 100644
--- a/docs/publishing/github-pages.qmd
+++ b/docs/publishing/github-pages.qmd
@@ -84,7 +84,8 @@ You usually do not need to do this --- `quarto publish gh-pages` will create the
 
 ``` {.bash filename="Terminal"}
 git checkout --orphan gh-pages
-git reset --hard # make sure all changes are committed before running this!
+# make sure all changes are committed before running this!
+git reset --hard
 git commit --allow-empty -m "Initialising gh-pages branch"
 git push origin gh-pages
 ```