From f9ea0f9d9b51271ff33afc6b8f71a2b78d8abcdb Mon Sep 17 00:00:00 2001
From: David Robertson <davidr@element.io>
Date: Thu, 2 Mar 2023 16:58:04 +0000
Subject: [PATCH] Only include endpoint path in `<summary>` (#1446)

---
 assets/scss/custom.scss                            | 14 +++++++++-----
 .../internal/newsfragments/1446.clarification      |  1 +
 layouts/partials/openapi/render-operation.html     |  2 +-
 3 files changed, 11 insertions(+), 6 deletions(-)
 create mode 100644 changelogs/internal/newsfragments/1446.clarification

diff --git a/assets/scss/custom.scss b/assets/scss/custom.scss
index 1534d5bd..9d748bd2 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/changelogs/internal/newsfragments/1446.clarification b/changelogs/internal/newsfragments/1446.clarification
new file mode 100644
index 00000000..fdc3d1fc
--- /dev/null
+++ b/changelogs/internal/newsfragments/1446.clarification
@@ -0,0 +1 @@
+Endpoint disclosures now hide everything but the URL.
diff --git a/layouts/partials/openapi/render-operation.html b/layouts/partials/openapi/render-operation.html
index 74b729cf..1e480671 100644
--- a/layouts/partials/openapi/render-operation.html
+++ b/layouts/partials/openapi/render-operation.html
@@ -33,6 +33,7 @@
    <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 @@
 
 <p>{{ $operation_data.description | markdownify }}</p>
 
-</summary>
 
 <table class="basic-info">
   <tr>