Document supported $args for register_rest_route()

[danielbachhuber]

$args seems awfully sparse for how important it is:

It would be nice if all of the supported values were documented.

[johnbillion]

I looked at documenting this recently but because the args array can take either an array of args or effectively multiple arrays of those args, I got disheartened trying to write the docs.