Align blog SEO with complete prose candidates

Author: lawrencecchen

web/app/[locale]/(landing)/guides/page.tsx

@@ -16,7 +16,10 @@ export async function generateMetadata({ params }: { params: Promise<{ locale: s
     locale,
     t,
     siteMeta,
-    ["title", "intro"],
+    {
+      complete: ["intro"],
+      context: ["title"],
+    },
   );
   return {
     title,

web/app/[locale]/(landing)/nightly/page.tsx

@@ -17,7 +17,10 @@ export async function generateMetadata({
     locale,
     t,
     siteMeta,
-    ["title", "description", "subtitle"],
+    {
+      complete: ["description", "subtitle"],
+      context: ["title"],
+    },
   );
   return {
     title,

web/i18n/audited-seo.ts

@@ -34,10 +34,7 @@ const blogDescriptionCandidateKeys: Record<
   sessionRestore: ["summary", "p1", "p2", "agentP2", "limitsP"],
   cmuxHome: ["summary", "p2", "p3", "p4"],
   introducingCmux: ["summary", "p1", "whyP"],
-  claudeCodeBestWorktreeManager: [
-    "summary",
-    "p1",
-  ],
+  claudeCodeBestWorktreeManager: ["summary", "p1"],
   zenOfCmux: ["summary", "p1", "p2", "p3", "p4"],
   cmdShiftU: ["summary", "p1"],
   unreadShortcuts: ["summary", "p1", "p2", "p3", "p4", "p5"],
@@ -195,28 +192,33 @@ export function blogPostSeoCopy(
   );
   return {
     title: selectTitle(locale, metadata("metaTitle"), siteMeta, [title]),
-    description: selectDescription(locale, metadata("metaDescription"), [
-      post("summary"),
-      `${title}. ${post("summary")}`,
-      ...authoredDescriptions,
-    ]),
+    description: selectDescription(locale, metadata("metaDescription"), {
+      completeCandidates: authoredDescriptions,
+      contextFragments: [title],
+    }),
   };
 }
 
 export function landingPageSeoCopy(
   locale: string,
   t: SeoMessageLookup,
   siteMeta: SeoMessageLookup,
-  candidateKeys: readonly string[],
+  candidateKeys: {
+    complete: readonly string[];
+    context: readonly string[];
+  },
 ) {
-  const authoredCandidates = candidateKeys.map((key) => t(key));
+  const completeCandidates = candidateKeys.complete.map((key) => t(key));
+  const contextFragments = candidateKeys.context.map((key) => t(key));
   return {
-    title: selectTitle(locale, t("metaTitle"), siteMeta, authoredCandidates),
-    description: selectDescription(
-      locale,
-      t("metaDescription"),
-      authoredCandidates,
-    ),
+    title: selectTitle(locale, t("metaTitle"), siteMeta, [
+      ...contextFragments,
+      ...completeCandidates,
+    ]),
+    description: selectDescription(locale, t("metaDescription"), {
+      completeCandidates,
+      contextFragments,
+    }),
   };
 }
 

web/tests/seo.test.ts

@@ -365,7 +365,10 @@ describe("SEO metadata helpers", () => {
             locale,
             messageLookup(messages.nightly),
             siteMeta,
-            ["title", "description", "subtitle"],
+            {
+              complete: ["description", "subtitle"],
+              context: ["title"],
+            },
           ),
           [
             messages.nightly.metaDescription,
@@ -381,7 +384,10 @@ describe("SEO metadata helpers", () => {
             locale,
             messageLookup(messages.landing.guides),
             siteMeta,
-            ["title", "intro"],
+            {
+              complete: ["intro"],
+              context: ["title"],
+            },
           ),
           [
             messages.landing.guides.metaDescription,