Update AIP-193 example with actionable error details (#1252)

* Make 0193.md example more actionable

Update example in AIP 193 with a more actionable error code and error details

* added metadata.zonesWithCapacity and removed whitespace between values

Author: andrei-scripniciuc

aip/general/0193.md

@@ -47,18 +47,19 @@ following:
     "details": [
       {
         "@type": "type.googleapis.com/google.rpc.ErrorInfo",
-        "reason": "STOCKOUT",
+        "reason": "RESOURCE_AVAILABILITY",
         "domain": "compute.googleapis.com",
         "metadata": {
           "zone": "us-east1-a",
           "vmType": "e2-medium",
-          "attachment": "local-ssd=3,nvidia-t4=2"
+          "attachment": "local-ssd=3,nvidia-t4=2",
+          "zonesWithCapacity": "us-central1-f,us-central1-c"
          }
        },
        {
         "@type": "type.googleapis.com/google.rpc.LocalizedMessage",
         "locale": "en-US",
-        "message": "A e2-medium with local-ssd=3,nvidia-t4=2 is currently unavailable in the us-east1-a zone.\nCapacity changes frequently, so try your request in a different zone, with a different VM hardware configuration, or at a later time. For more information, see troubleshooting documentation."
+        "message": "An <e2-medium> VM instance with <local-ssd=3,nvidia-t4=2> is currently unavailable in the <us-east1-a> zone.\n Consider trying your request in the <us-central1-f,us-central1-c> zone(s), which currently has/have capacity to accommodate your request.\n Alternatively, you can try your request again with a different  VM hardware configuration or at a later time. For more information, see the troubleshooting documentation."
        }
     ]
   }
@@ -264,6 +265,7 @@ message, which would be a backwards incompatible change.
 
 ## Changelog
 
+- **2023-10-24**: Updated the example error with more actionable details.
 - **2023-05-17**: Change the recommended language for `Status.message`
   to be the service's native language rather than English.
 - **2023-05-17**: Specify requirements for changing error messages.