Review and improve Admin REST documentation
The current Admin REST documentation is far from great and there are too many issues with it to list here, which should be covered by a thorough review.
As part of the Account REST API we are introducing we are also addressing how to properly document a REST API. Once we have good quality documentation for the Account REST API that will serve as an example of how the Admin REST documentation should be done. As such this work is on hold until we have completed documentation for Account REST API.