Docs: move warning from embed API to the top (#11053)

readthedocs · Jan 23, 2024 · b212a4d · b212a4d
1 parent 8658522
commit b212a4d
Showing 1 changed file with 5 additions and 5 deletions.
diff --git a/docs/user/api/v3.rst b/docs/user/api/v3.rst
@@ -1894,6 +1894,11 @@ Embed
     Retrieve HTML-formatted content from documentation page or section.
     Read :doc:`/guides/embedding-content` to know more about how to use this endpoint.
 
+    .. warning::
+
+       The content will be returned as is, without any sanitization or escaping.
+       You should not include content from arbitrary projects, or projects you do not trust.
+
     **Example request**:
 
     .. prompt:: bash $
@@ -1925,11 +1930,6 @@ Embed
        Passing ``?doctool=`` and ``?doctoolversion=`` may improve the response,
        since the endpoint will know more about the exact structure of the HTML and can make better decisions.
 
-    .. warning::
-
-       The content will be returned as is, without any sanitization or escaping.
-       You should not include content from arbitrary projects, or projects you do not trust.
-
 Additional APIs
 ---------------