By adding documentation for REST Interface , Multi Client and self signed Certificate authentication
Documentation for REST Interface is very confusing as;
1) ARM specific operations and urls are mixed together with APIM service instance specific endpoints and operations.
2) PUT operations are titled as "Create or Update" operation while PATCH operation are marked as "Update" operation. This is confusing and costed us an outage; "Update" operation should be named as "Partial update" or "PATCH" operation in title. example:
POST operation is create operation
PUT is update
PATCH is partial update
3) also the documentation should explain all the possible values of property attribute like
"virtualNetworkType": "None". //in documentation
"virtualNetworkType": "External" //not present in doc
"virtualNetworkType": "Internal" //not present in doc
4) Documentation for Client Certificate based authentication doesn't mention anything about selfsigned certificates and their validation or about multi client authentication using multiple certificates to single api and their examples.