From 4621f6447dc8566a8b72cb3b18e8bf7fa076157f Mon Sep 17 00:00:00 2001
From: David Robertson <davidr@element.io>
Date: Wed, 22 Feb 2023 21:02:44 +0000
Subject: [PATCH 1/2] Only include endpoint path in `<summary>`

---
 assets/scss/custom.scss                        | 14 +++++++++-----
 layouts/partials/openapi/render-operation.html |  2 +-
 2 files changed, 10 insertions(+), 6 deletions(-)

diff --git a/assets/scss/custom.scss b/assets/scss/custom.scss
index 1534d5bdd..9d748bd22 100644
--- a/assets/scss/custom.scss
+++ b/assets/scss/custom.scss
@@ -288,16 +288,20 @@ footer {
 /* Styles for sections that are rendered from data, such as HTTP APIs and event schemas */
 .rendered-data {
   background-color: $secondary-lightest-background;
-  padding: 1rem;
-  margin: 1rem 0;
+  padding: 0.85rem;
+  margin: 0.85rem 0;
 
   details {
     summary {
-      padding: .5rem 0;
-      p {
-        max-width: 80%;
+      h1 {
+        margin: 0;
+        /* Ensure the disclosure control is vertically centred with the header text. */
+        vertical-align: middle;
       }
     }
+    p {
+      max-width: 80%;
+    }
   }
 
   .deprecated-inline {
diff --git a/layouts/partials/openapi/render-operation.html b/layouts/partials/openapi/render-operation.html
index 74b729cfb..1e4806714 100644
--- a/layouts/partials/openapi/render-operation.html
+++ b/layouts/partials/openapi/render-operation.html
@@ -33,6 +33,7 @@ <h1 id="{{ lower $method }}{{ $anchor }}">
    <span class="http-api-method {{ $method }}">{{ $method }}</span>
    <span class="endpoint{{ if $operation_data.deprecated }} deprecated-inline{{ end }}">{{ $endpoint }}</span>
   </h1>
+</summary>
 
   <hr/>
 
@@ -49,7 +50,6 @@ <h1 id="{{ lower $method }}{{ $anchor }}">
 
 <p>{{ $operation_data.description | markdownify }}</p>
 
-</summary>
 
 <table class="basic-info">
   <tr>

From 9da4eaf8ac617f8584e9fc7c1384182d34b3dc06 Mon Sep 17 00:00:00 2001
From: David Robertson <davidr@element.io>
Date: Wed, 22 Feb 2023 21:10:23 +0000
Subject: [PATCH 2/2] Changelog

---
 changelogs/internal/newsfragments/1446.clarification | 1 +
 1 file changed, 1 insertion(+)
 create mode 100644 changelogs/internal/newsfragments/1446.clarification

diff --git a/changelogs/internal/newsfragments/1446.clarification b/changelogs/internal/newsfragments/1446.clarification
new file mode 100644
index 000000000..fdc3d1fc6
--- /dev/null
+++ b/changelogs/internal/newsfragments/1446.clarification
@@ -0,0 +1 @@
+Endpoint disclosures now hide everything but the URL.