I think these 4 paragraphs can be replaced by just showing them *how* the descriptors are used right now:

``` bash
    php app.php some:command --format=json
```

and then say "you can create a custom descriptor to output these help options in a different format, like YAML". This would also be a good spot to mention all the built-in descriptors.