API-6990 - Tidy up the OAS docs link (hmrc#468)

d6fb · Jun 15, 2023 · a6f4c11 · a6f4c11
1 parent a68cfab
commit a6f4c11
Showing 1 changed file with 18 additions and 14 deletions.
diff --git a/app/uk/gov/hmrc/apidocumentation/views/openapispec/ParentPageView.scala.html b/app/uk/gov/hmrc/apidocumentation/views/openapispec/ParentPageView.scala.html
@@ -56,13 +56,6 @@ <h1 id="title" class="govuk-heading-l">
         </h1>
         @for(version <- maybeVersion) {
             <table class="govuk-table">
-                <caption class="visually-hidden">Dates and amounts</caption>
-                <thead class="visually-hidden">
-                  <tr class="govuk-table__row">
-                    <th scope="col" class="govuk-table__header">Date</th>
-                    <th scope="col" class="govuk-table__header">Amount</th>
-                  </tr>
-                </thead>
                 <tbody class="govuk-table__body">
                     <tr class="govuk-table__row">
                         <th scope="row" class="govuk-table__header">Version and status</th>
@@ -110,21 +103,32 @@ <h2 id="@Slugify(doc.title)-title" class="govuk-heading-m">
 
         @defining(VersionDocsVisible(maybeVersion.flatMap(_.visibility))) { case visibility =>
             @if(visibility == DocsVisibility.VISIBLE) {
-                <section id="view-oas" class="section">
+                <section id="endpoints" class="section">
                   <h2 id="endpoints-title" class="govuk-heading-m">
                       Endpoints
                   </h2>
 
-                  <p class="govuk-body">The way we show <a class="govuk-link" href="@controllers.routes.OpenApiDocumentationController.renderApiDocumentation(maybeApi.get.serviceName, maybeVersion.get.version).url">@{title} API v@{maybeVersion.get.version} endpoints</a> has changed, which might look different to other Developer Hub APIs.</p>
-
-                  <p class="govuk-body">The API has not changed. You do not need to make any updates to your application if you already use this API.</p>
+                  <a class="govuk-button govuk-button-secondary" href="@controllers.routes.OpenApiDocumentationController.renderApiDocumentation(maybeApi.get.serviceName, maybeVersion.get.version).url">
+                    View API endpoints
+                  </a>
 
+                  <details class="govuk-details" data-module="govuk-details">
+                    <summary class="govuk-details__summary">
+                      <span class="govuk-details__summary-text">
+                        Why do these endpoints look different?
+                      </span>
+                    </summary>
+                    <div class="govuk-details__text">
+                      <p class="govuk-body"> The endpoints for this API now use the Open API Specification (OAS).</p>
+                      <p class="govuk-body">The API has not changed. You do not need to make any updates to your application if you already use this API.</p>
+                    </div>
+                  </details>
                 </section>
             } else {
                 @if(visibility == DocsVisibility.OVERVIEW_ONLY) {
-                  <section id="read-more" class="section">
-                    <h2 id="read-more-title" class="govuk-heading-m">
-                        Read more
+                  <section id="endpoints" class="section">
+                    <h2 id="endpoints-title" class="govuk-heading-m">
+                        Endpoints
                     </h2>
                     <p class="govuk-body">To see the complete documentation for this API and join the private trial,
                         <a class="govuk-link" href="@{applicationConfig.developerFrontendUrl}/developer/support">contact support</a>.