Update docs around positional arguments.
Add callout for subcommands.

Document that subcommand parsers are all or nothing.
small fixes in a sentence for clarity
Merge pull request #1329 from cakephp/3.0-shell-args

3.0 shell args