From 48791c1fae5a31921678105680ef583bd152b886 Mon Sep 17 00:00:00 2001
From: Charlotte Wickham <cwickham@gmail.com>
Date: Mon, 28 Sep 2026 14:23:26 -0700
Subject: [PATCH] Use h2 for listing card titles and a paragraph for subtitles

Fixes axe heading-order on the Guide and Reference index pages.
CSS keeps the previous h4/h6 appearance.
---
 ejs/links.ejs |  4 ++--
 styles.css    | 16 +++++++++++++++-
 2 files changed, 17 insertions(+), 3 deletions(-)

diff --git a/ejs/links.ejs b/ejs/links.ejs
index 2b85ea496c..74a702ed80 100644
--- a/ejs/links.ejs
+++ b/ejs/links.ejs
@@ -7,10 +7,10 @@
 ::: {.card-body}
 
 ::: {.card-title}
-#### <%- item.title %>
+## <%- item.title %>
 <% if (item.subtitle) { %>
 ::: {.card-subtitle .text-muted}
-###### <%- item.subtitle %>
+<%- item.subtitle %>
 :::
 <% } %>
 :::
diff --git a/styles.css b/styles.css
index c946f5b0a4..cdfb0ce630 100644
--- a/styles.css
+++ b/styles.css
@@ -176,8 +176,16 @@ iframe.reveal-demo {
   padding: 0;
 }
 
-.link-cards .card-title h4 {
+/* Card titles are h2 for heading order; keep the old h4 look */
+.link-cards .card-title h2 {
+  font-size: 1.25rem;
+  font-weight: 400;
+  line-height: 1.2;
+  opacity: 0.9;
   margin-top: 0;
+  margin-bottom: 0.5rem;
+  padding-bottom: 0;
+  border-bottom: none;
 }
 
 .link-cards .card-title p {
@@ -188,6 +196,12 @@ iframe.reveal-demo {
   margin-bottom: 0.7rem;
 }
 
+.link-cards .card-subtitle p {
+  line-height: 1.2;
+  opacity: 0.9;
+  margin-bottom: 0.5rem;
+}
+
 .link-cards .card-body {
   padding: 0.5rem;
   padding-left: 0.1rem;