Update docs

spring-shell-docs/src/main/asciidoc/using-shell-options-arity.adoc

@@ -42,3 +42,12 @@ include::{snippets}/OptionSnippets.java[tag=option-registration-arityenum]
 |ONE_OR_MORE
 |1 / Integer MAX
 |===
+
+Annotation model only supports defining _max_ value of an arity.
+
+====
+[source, java, indent=0]
+----
+include::{snippets}/OptionSnippets.java[tag=option-with-annotation-arity]
+----
+====

spring-shell-docs/src/main/asciidoc/using-shell-options-default.adoc

@@ -13,3 +13,12 @@ based on a default value.
 include::{snippets}/OptionSnippets.java[tag=option-registration-default]
 ----
 ====
+
+With an annotation model default value can be defined.
+
+====
+[source, java, indent=0]
+----
+include::{snippets}/OptionSnippets.java[tag=option-with-annotation-default]
+----
+====

spring-shell-docs/src/main/asciidoc/using-shell-options-optional.adoc

@@ -11,3 +11,13 @@ a command target how this behaves.
 include::{snippets}/OptionSnippets.java[tag=option-registration-optional]
 ----
 ====
+
+With an annotation model there is no direct way to define if argument is
+optional, instead it's instructed to be _NULL_.
+
+====
+[source, java, indent=0]
+----
+include::{snippets}/OptionSnippets.java[tag=option-with-annotation-optional]
+----
+====

spring-shell-docs/src/main/asciidoc/using-shell-options-short.adoc

@@ -25,3 +25,12 @@ as `-abc`, `-abc true` or `-abc false`.
 include::{snippets}/OptionSnippets.java[tag=option-registration-shortargbooleans]
 ----
 ====
+
+With annotation model you can define short argument directly.
+
+====
+[source, java, indent=0]
+----
+include::{snippets}/OptionSnippets.java[tag=option-with-annotation-shortarg]
+----
+====