From 6d9cdbe4eeabb50c910a8b0ede69edb5af9b377c Mon Sep 17 00:00:00 2001
From: petradonka <donkapetra@gmail.com>
Date: Fri, 26 Jun 2026 07:06:55 +0000
Subject: [PATCH] Automated SEO fixes: resolve multiple H1 on /api and trim SSH
 description

- src/pages/api.astro: demote the server-rendered endpoint-index spec
  title from <h1> to <h2> (and per-endpoint headings <h2> to <h3>) so
  the page has a single H1 ("Warp & Oz HTTP API reference"), fixing the
  multiple_h1 SEO warning while keeping a clean h1 > h2 > h3 outline.
- src/content/docs/terminal/warpify/ssh.mdx: trim the meta description
  from 162 to 159 chars ("to get a" -> "for a") so it is no longer
  truncated in search results.

Co-Authored-By: Oz <oz-agent@warp.dev>
---
 src/content/docs/terminal/warpify/ssh.mdx | 2 +-
 src/pages/api.astro                       | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/content/docs/terminal/warpify/ssh.mdx b/src/content/docs/terminal/warpify/ssh.mdx
index 1e6a67b7..ae674c88 100644
--- a/src/content/docs/terminal/warpify/ssh.mdx
+++ b/src/content/docs/terminal/warpify/ssh.mdx
@@ -1,7 +1,7 @@
 ---
 title: SSH with Warp features
 description: >-
-  Use Warp's SSH extension on remote macOS and Linux hosts to get a real file
+  Use Warp's SSH extension on remote macOS and Linux hosts for a real file
   tree, code editing, code review, codebase indexing, and reliable completions
   over SSH.
 ---
diff --git a/src/pages/api.astro b/src/pages/api.astro
index 092b8fb2..67f42c68 100644
--- a/src/pages/api.astro
+++ b/src/pages/api.astro
@@ -206,7 +206,7 @@ const specBaseUrl = (specObject.servers as Array<{ url?: string }> | undefined)?
       any HTTP client that reads HTML — including AI crawlers, scanners and agents.
     -->
     <section aria-label="Oz Agent API endpoint index" style="position:absolute;width:1px;height:1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;">
-      <h1>{specInfo?.title}</h1>
+      <h2>{specInfo?.title}</h2>
       <p>{specInfo?.description}</p>
       <p>Base URL: {specBaseUrl}</p>
       <p>Authentication: Bearer token (Warp API key). Obtain from account settings. Pass as Authorization: Bearer YOUR_API_KEY.</p>
@@ -215,7 +215,7 @@ const specBaseUrl = (specObject.servers as Array<{ url?: string }> | undefined)?
         <article>
           {Object.entries(methods).filter(([method]) => HTTP_METHODS.has(method)).map(([method, op]) => (
             <section>
-              <h2>{method.toUpperCase()} {endpointPath}</h2>
+              <h3>{method.toUpperCase()} {endpointPath}</h3>
               {op.summary && <p>{op.summary}</p>}
               {op.description && <p>{op.description}</p>}
               {op.parameters && op.parameters.length > 0 && (