added example on how to use InputArgument::IS_ARRAY, added overview of a...

...ll three argument variants

| Q             | A
| ------------- | ---
| Doc fix?      | yes
| New docs?     | no
| Applies to    | all
| Fixed tickets | #2686