apidocs: Move stray events description text to OpenAPI.

templates/zerver/api/get-events.md

@@ -50,12 +50,4 @@ a queue for you.
 
 {generate_code_example|/events:get|fixture(200)}
 
-#### BAD_EVENT_QUEUE_ID errors
-
 {generate_code_example|/events:get|fixture(400)}
-
-A compliant client will handle this error by re-initializing itself
-(e.g. a Zulip web app browser window will reload in this case).
-
-See [the /register endpoint docs](/api/register-queue) for details on how to
-handle these correctly.

zerver/openapi/zulip.yaml

@@ -3867,8 +3867,16 @@ paths:
                 allOf:
                   - $ref: "#/components/schemas/BadEventQueueIdError"
                   - description: |
-                      If the target event queue has been garbage collected, you'll get the
-                      following error response
+                      #### BAD_EVENT_QUEUE_ID errors
+
+                      This error occurs if the target event queue has been garbage collected.
+                      A compliant client will handle this error by re-initializing itself
+                      (e.g. a Zulip web app browser window will reload in this case).
+
+                      See [the /register endpoint docs](/api/register-queue) for details on how to
+                      handle these correctly.
+
+                      The following is the error response in such case
     delete:
       operationId: delete_queue
       summary: Delete an event queue