Tweaks proposed by reviewers

Author: javiereguiluz

console/input.rst

@@ -134,9 +134,9 @@ how many times in a row the message should be printed::
     $this
         // ...
         ->addOption(
-            // this is the name that users must type to pass this option
+            // this is the name that users must type to pass this option (e.g. --iterations=5)
             'iterations',
-            // this is the shortcut of the option name, which usually is just a letter
+            // this is the optional shortcut of the option name, which usually is just a letter
             // (e.g. `i`, so users pass it as `-i`); use it for commonly used options
             // or options with long names
             null,