diff --git a/docs/command-line-syntax.md b/docs/command-line-syntax.md
index 684da5799..c4914bea5 100644
--- a/docs/command-line-syntax.md
+++ b/docs/command-line-syntax.md
@@ -37,3 +37,10 @@ Ellipsis represent arguments that can appear multiple times
 
 _*example:*_
 `gh pr close <numbers … >`
+
+## Variable naming
+
+For multi-word variables use dash-case (all lower case with words seperated by dashes)
+
+_*example:*_
+`gh pr checkout <issue-number>`