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.

[vishalkakadiya]

I agreed with @johnbillion, documenting the $args parameter is complex due to its flexibility as it can accept a variety of configurations, including nested arrays for complex parameters, making it challenging to provide exhaustive documentation.

• [ ] Added documentation for register_rest_route() parameter: $args
• [ ] Improved documentation for register_rest_route() parameter: $route

[vladimiraus]

Added patch. Please review.

[SirLouen]

@vladimiraus this was opened two years ago, it can't belong to trunk, plus it's an enhancement. So it doesn't need version.

Moreover, given it's a docs, it doesn't need a need-testing tag.

[vladimiraus]

Thanks @SirLouen for clarification