Update doc

probablycorey · probablycorey · commit 67f65a09d012 · 2020-05-07T09:28:34.000-07:00
diff --git a/docs/command-line-syntax.md b/docs/command-line-syntax.md
@@ -1,8 +1,8 @@
 # How we document our command line syntax
 
-## Required arguments
+## Required text
 
-Use plain text
+Use plain text for any part of the command that can not be changed
 
 _*example:*_
 `gh help`
@@ -36,11 +36,19 @@ _*example:*_
 Ellipsis represent arguments that can appear multiple times
 
 _*example:*_
-`gh pr close <numbers … >`
+`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>`
+
+## Complex examples
+
+_*required argument with mutually exclusive optoins:*_
+`gh pr close <{number | url}>`
+
+_*optional argument with mutually exclusive optoins:*_
+`gh pr close [{<number> | <url>}]`
