Better named specs from user guide

Author: beccasaurus

docs/_pages/index.md

@@ -448,9 +448,42 @@ myCommand arg1 arg2 > "log.log"
 # Conditionals
 
 ## `if / fi`
+
+- `if` conditionals are supported (`then` _is an optional keyword_)
+
+```sh
+- if [ '$#' -eq 0 ]
+  - comment Hello
+- elif [ '$#' -eq 1 ]
+- else
+  - echo "Hello, world"
+- fi
+```
+
+<!-- OUTPUT -->
+
+```sh
+if [ $# -eq 0 ]
+then
+  # Hello
+  :
+elif [ $# -eq 1 ]
+then
+  :
+else
+  echo "Hello, world"
+fi
+```
+
+ℹ️ Empty blocks (_or those with only comments_) automatically have a `:` added
+
 ## `case / option / esac`
+
+
+
 ## `[ ... ] AND / OR`
 
+
 # Loops
 
 ## `for`

examples/documentation/userGuide/Conditionals_if__fi.spec.sh

@@ -0,0 +1,31 @@
+source shellpen.sh
+
+shellpen -
+
+commandGroup1() {
+  - if [ '$#' -eq 0 ]
+    - comment Hello
+  - elif [ '$#' -eq 1 ]
+  - else
+    - echo "Hello, world"
+  - fi
+  - code
+}
+
+@spec.commandGroup1() {
+  read -r -d '' expected <<'EXPECTED'
+if [ $# -eq 0 ]
+then
+  # Hello
+  :
+elif [ $# -eq 1 ]
+then
+  :
+else
+  echo "Hello, world"
+fi
+
+EXPECTED
+  expect { commandGroup1 } toContain "$expected"
+}
+