Merge pull request #12 from DavideDaniel/claude/add-seo-fixes-6Aihk

DavideDaniel · web-flow · commit e078ffe53b87 · 2026-02-26T23:08:27.000-08:00
Enhance SEO with structured data, Open Graph tags, and crawler support
diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md
@@ -171,3 +171,15 @@ function smoothScrollTo(targetId) {
 ```
 
 This helps both GitHub Copilot and Claude understand the codebase better!
+
+## SEO Requirements
+
+This portfolio site is the root deployment for `daviddaniel.tech`. It serves as the crawl entry point for all content including the research subsite at `/research/`.
+
+### Critical Rules
+
+- **`public/robots.txt`** is the canonical robots.txt for the entire daviddaniel.tech domain. Do not remove it or move it to another location.
+- **`index.html`** must always contain a server-rendered (non-JS) link to `/research/` so search engine crawlers can discover the research subsite. Do not remove the `<noscript>` block or the crawlable anchor link.
+- Any navigation changes must preserve crawlable links to the research section.
+- The `<head>` section of `index.html` contains structured data (JSON-LD), Open Graph tags, and a canonical URL. These must be maintained when editing the file.
+- If new pages are added, consider whether they need `noindex` meta tags (e.g., draft or private content).
diff --git a/index.html b/index.html
@@ -4,11 +4,61 @@
     <meta charset="UTF-8" />
     <link rel="icon" type="image/x-icon" href="/favicon.ico" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <meta name="description" content="David Daniel - Principal Engineer" />
+    <meta name="description" content="David Daniel - Principal Engineer. Portfolio, technical research, and musings on AI engineering, software architecture, and modern development practices." />
+    <meta name="author" content="David Daniel" />
+    <link rel="canonical" href="https://daviddaniel.tech/" />
     <title>David Daniel | Principal Engineer</title>
+
+    <!-- Open Graph -->
+    <meta property="og:type" content="website" />
+    <meta property="og:title" content="David Daniel | Principal Engineer" />
+    <meta property="og:description" content="Portfolio, technical research, and musings on AI engineering, software architecture, and modern development practices." />
+    <meta property="og:url" content="https://daviddaniel.tech/" />
+    <meta property="og:site_name" content="David Daniel" />
+    <meta property="og:locale" content="en_US" />
+
+    <!-- Twitter Card -->
+    <meta name="twitter:card" content="summary" />
+    <meta name="twitter:title" content="David Daniel | Principal Engineer" />
+    <meta name="twitter:description" content="Portfolio, technical research, and musings on AI engineering, software architecture, and modern development practices." />
+
+    <!-- Structured Data -->
+    <script type="application/ld+json">
+      {
+        "@context": "https://schema.org",
+        "@type": "WebSite",
+        "name": "David Daniel",
+        "url": "https://daviddaniel.tech/",
+        "description": "Portfolio, technical research, and musings on AI engineering, software architecture, and modern development practices.",
+        "author": {
+          "@type": "Person",
+          "name": "David Daniel",
+          "jobTitle": "Principal Engineer",
+          "url": "https://daviddaniel.tech/",
+          "sameAs": [
+            "https://linkedin.com/in/davidedaniel/",
+            "https://github.com/DavideDaniel"
+          ]
+        }
+      }
+    </script>
   </head>
   <body>
     <div id="root"></div>
     <script type="module" src="/src/main.jsx"></script>
+
+    <!-- Server-rendered navigation for search engine crawlability -->
+    <noscript>
+      <nav>
+        <h1>David Daniel | Principal Engineer</h1>
+        <ul>
+          <li><a href="/bio">Bio</a></li>
+          <li><a href="/musings">Musings on AI Engineering</a></li>
+          <li><a href="/research/">Technical Research</a></li>
+        </ul>
+      </nav>
+    </noscript>
+    <!-- Crawlable link to research subsite (hidden, replaced by React app on render) -->
+    <a href="/research/" style="position:absolute;left:-9999px;opacity:0" aria-hidden="true" tabindex="-1">Technical Research</a>
   </body>
 </html>
diff --git a/public/robots.txt b/public/robots.txt
@@ -0,0 +1,5 @@
+User-agent: *
+Allow: /
+Disallow: /research/musings/
+
+Sitemap: https://daviddaniel.tech/research/sitemap.xml
