From 1388742a52876f9b13d5f05631baf5ae3959825e Mon Sep 17 00:00:00 2001
From: Travis Ralston <travpc@gmail.com>
Date: Wed, 20 May 2020 18:00:27 -0600
Subject: [PATCH] Mention that we use OpenAPI 3's response code format

See comments of https://github.com/matrix-org/matrix-doc/pull/2238
---
 api/openapi_extensions.md | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/api/openapi_extensions.md b/api/openapi_extensions.md
index 339452ba..fced21fc 100644
--- a/api/openapi_extensions.md
+++ b/api/openapi_extensions.md
@@ -43,3 +43,11 @@ doesn't work, as in the following example:
           properties:
             ...
 ```
+
+## OpenAPI 3's "2xx" format for response codes
+
+<!-- TODO: Remove this section after upgrading to OpenAPI v3 -->
+
+In some cases, the schema will have HTTP response code definitions like
+`2xx`, `3xx`, and `4xx`. These indicate that a response code within those
+ranges (`2xx` = `200` to `299`) is valid for the schema.