From bea1e53bf0f32db6b09b6ef8cf65980a2ebfae2d Mon Sep 17 00:00:00 2001
From: Tim Bannister <193443691+lmktfy@users.noreply.github.com>
Date: Fri, 31 Oct 2025 16:50:53 +0000
Subject: [PATCH] Update docs landing page to align with Docsy

Use Docsy-compatible styles for docs landing page.
This revises the appearance; it is not a like-for-like change.
---
 assets/scss/_documentation.scss   | 98 ++++++++++++++++++++++++++-----
 layouts/docs/docsportal_home.html | 15 +----
 2 files changed, 85 insertions(+), 28 deletions(-)

diff --git a/assets/scss/_documentation.scss b/assets/scss/_documentation.scss
index f2f070b1d87..5f29384b7cc 100644
--- a/assets/scss/_documentation.scss
+++ b/assets/scss/_documentation.scss
@@ -376,24 +376,38 @@ body.glossary {
   background: #f8f9cb;
 }
 
-#mainContent .launch-content {
+// Docs landing page styles
+body.docs-portal {
+  .td-content > h1:first-child {
+    text-align: center;
+    color: $primary;
+    padding-top: 0;
+  }
 
   .launch-cards {
     padding: 0;
     display: grid;
+
     grid-template-columns: repeat(3, 1fr);
-    row-gap: 1em;
+
+    row-gap: 0.5rem;
+    column-gap: 0.5rem;
+
     .launch-card {
+      border-radius: 0.75rem;
+      padding: 0.25rem 0.75rem;
       display: flex;
-      padding: 0 30px 0 0;
-      .card-content{
-        width: fit-content;
+
+      .card-content {
         display: flex;
         flex-direction: column;
+        flex-grow: 1;
         margin: 0;
+
         row-gap: 1em;
+
         h2 {
-          font-size: 1.75em;
+          font-size: 1.5em;
           padding: 0.5em 0;
           margin: 0;
           a {
@@ -405,38 +419,92 @@ body.glossary {
           margin: 0;
         }
 
-        ul {
+        > ul {
           list-style: none;
           height: fit-content;
           line-height: 1.6;
           padding: 0;
+          padding-left: 1rem;
           margin-block-end: auto;
-        }
 
-        br {
-          display: none;
+          > li:last-child {
+            margin-bottom: 1rem;
+          }
         }
 
         button {
+          min-width: 75%;
+          align-self: center;
+          background: $primary;
+          color: $white;
+          border: 0;
+          font-weight: bold;
+          border-radius: 0.5rem;
           height: min-content;
           width: auto;
           padding: .5em 1em;
           cursor: pointer;
           box-sizing: border-box;
+          margin-bottom: 0.25rem;
         }
       }
     }
 
-    @media only screen and (max-width: 1000px) {
-      grid-template-columns: 1fr;
-      .launch-card {
-        width: 100%;
+    .launch-card:has(button) {
+      background: rgba(210, 210, 210, 0.2);
+      color: $black;
+    }
+
+    .launch-card:hover {
+      background: rgba(210, 210, 210, 0.4);
+    }
+
+    .launch-card:has(button:hover) {
+      outline: 0.2rem solid $primary;
+      button, button:hover {
+        background: $primary;
+        color: $white;
       }
     }
+
+    .launch-card button:hover {
+      outline: 0.2rem solid white;
+    }
+
+    grid-template-columns: repeat(1, 1fr);
+
+    @include media-breakpoint-up(xl) {
+      margin-left: auto;
+      margin-right: auto;
+      row-gap: 1rem;
+      column-gap: 1rem;
+      .launch-card {
+        .card-content {
+          width: fit-content;
+          flex-grow: initial;
+        }
+        max-width: calc(min(80vw, 40em));
+        padding: 0.75rem;
+        > .card-content button {
+          align-self: flex-end;
+        }
+      }
+    }
+    @media (max-width: 60rem) {
+      row-gap: 0.75rem;
+      .launch-card {
+        border-radius: 0.333rem;
+      }
+    }
+    @media (min-width: 60rem) {
+      grid-template-columns: repeat(2, 1fr);
+    }
+    @media (min-width: 120rem) {
+      grid-template-columns: repeat(3, 1fr);
+    }
   }
 }
 
-
 /* SCSS related to the list of metrics in Kubernetes */
 main {
 
diff --git a/layouts/docs/docsportal_home.html b/layouts/docs/docsportal_home.html
index 9d58f5093a8..46c5730e7a3 100644
--- a/layouts/docs/docsportal_home.html
+++ b/layouts/docs/docsportal_home.html
@@ -1,11 +1,5 @@
 {{ define "main" }}
-    {{ template "docs-portal-content" . }}
-{{ end }}
-
-{{ define "content-id" }}content{{ end }}
-
-{{ define "docs-portal-content" }}
-  <section id="mainContent">
+  <div class="td-content">
   <div class="launch-content">
     <p>{{ .Params.overview | safeHTML }}</p>
     <br>
@@ -15,10 +9,5 @@
       {{ $page }}
     </div>
   </div>
-</section>
-{{ end }}
-{{ define "hero" }}
-    <section class="header-hero text-white pb-4 light-text ">
-    <h1>{{ .Title }}</h1>
-    </section>
+  </div>
 {{ end }}