relax guarantee on openapi rate limit doc accuracy

diff --git a/support/doc/api/openapi.yaml b/support/doc/api/openapi.yaml
index e448bc1c9a79fb412d17986af201cb2f6cf57ffe..90e30545f4f6f4461b96e1d0b0229f18f1a3c834 100644 (file)
--- a/support/doc/api/openapi.yaml
+++ b/support/doc/api/openapi.yaml
@@ -50,7 +50,8 @@ info:
 
     # Rate limits
 
-    We are rate-limiting all endpoints of PeerTube's API. Here is how it is configured by default:
+    We are rate-limiting all endpoints of PeerTube's API. Custom values can be configured
+    by administrators:
 
     | Endpoint                | Calls            | Time frame                |
     |-------------------------|------------------|---------------------------|
@@ -62,7 +63,8 @@ info:
     Depending on the endpoint, ¹failed requests are not taken into account. A service
     limit is announced by a `429 Too Many Requests` status code.
 
-    You can get details about how your rate limit is going by reading following headers:
+    You can get details about the current state of your rate limit by reading the
+    following headers:
 
     | Header                  | Description                                                |
     |-------------------------|------------------------------------------------------------|