From ac33e7ce8e1be83d44866e723f385e0cc4a02ed6 Mon Sep 17 00:00:00 2001
From: Guanzhou Song <guanzhou.song@gmail.com>
Date: Thu, 30 Jul 2026 12:35:18 -0400
Subject: [PATCH] Give reference listing pages a real h1

The MQL reference index, type, and category pages used an h2 as their
top-level heading, leaving those pages with no h1 at all. Individual
reference entries are fine - their h1 comes from the compiled markdown
(each entry in documentdb/docs starts with an h1 title) - so only the
three listing pages change. Styling classes are unchanged; the
_metadata.description.md blurbs rendered below are plain paragraphs
with no headings, so no heading-order conflict is introduced.
---
 app/docs/reference/[type]/[category]/page.tsx | 4 ++--
 app/docs/reference/[type]/page.tsx            | 4 ++--
 app/docs/reference/page.tsx                   | 4 ++--
 3 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/app/docs/reference/[type]/[category]/page.tsx b/app/docs/reference/[type]/[category]/page.tsx
index 6ec5618..5c2bf18 100644
--- a/app/docs/reference/[type]/[category]/page.tsx
+++ b/app/docs/reference/[type]/[category]/page.tsx
@@ -38,9 +38,9 @@ export default async function CommandReferencePage({ params }: { params: Promise
     <article>
       <Breadcrumb type={type} category={category} />
       <div className="mb-8">
-        <h2 className="text-4xl font-bold text-white mb-4 capitalize">
+        <h1 className="text-4xl font-bold text-white mb-4 capitalize">
           MongoDB Query Language (MQL) {capitalCase(category)} {capitalCase(pluralize(type))}
-        </h2>
+        </h1>
         <div className="w-24 h-1 bg-gradient-to-r from-blue-500 via-purple-500 to-green-500 rounded-full mb-6"></div>
         {description && (
           <div className="text-gray-400 text-lg mb-6">
diff --git a/app/docs/reference/[type]/page.tsx b/app/docs/reference/[type]/page.tsx
index 3cb97e4..4f51a0d 100644
--- a/app/docs/reference/[type]/page.tsx
+++ b/app/docs/reference/[type]/page.tsx
@@ -37,9 +37,9 @@ export default async function CommandReferencePage({ params }: { params: Promise
     <article>
       <Breadcrumb type={type} />
       <div className="mb-8">
-        <h2 className="text-4xl font-bold text-white mb-4 capitalize">
+        <h1 className="text-4xl font-bold text-white mb-4 capitalize">
           MongoDB Query Language (MQL) {capitalCase(pluralize(type))}
-        </h2>
+        </h1>
         <div className="w-24 h-1 bg-gradient-to-r from-blue-500 via-purple-500 to-green-500 rounded-full mb-6"></div>
         {description && (
           <div className="text-gray-400 text-lg mb-6">
diff --git a/app/docs/reference/page.tsx b/app/docs/reference/page.tsx
index 3ff1963..714352e 100644
--- a/app/docs/reference/page.tsx
+++ b/app/docs/reference/page.tsx
@@ -23,9 +23,9 @@ export default function Home() {
     <article>
       <Breadcrumb />
       <div className="mb-8">
-        <h2 className="text-4xl font-bold text-white mb-4">
+        <h1 className="text-4xl font-bold text-white mb-4">
           MongoDB Query Language (MQL)
-        </h2>
+        </h1>
         <div className="w-24 h-1 bg-gradient-to-r from-blue-500 via-purple-500 to-green-500 rounded-full mb-6"></div>
         {description && (
           <div className="text-gray-400 text-lg mb-6">