Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
51 commits
Select commit Hold shift + click to select a range
d39be53
Fix site metadata audit findings
lawrencecchen Jul 11, 2026
7bfa15f
Merge remote-tracking branch 'origin/main' into feat-seo-site-audit
lawrencecchen Jul 11, 2026
85b9d5a
Harden localized metadata truncation
lawrencecchen Jul 11, 2026
710120a
Keep metadata on grapheme boundaries
lawrencecchen Jul 11, 2026
63bfbe0
Preserve localized home title context
lawrencecchen Jul 11, 2026
ea18e20
Preserve metadata source language
lawrencecchen Jul 11, 2026
3d6a523
Canonicalize untranslated SEO routes
lawrencecchen Jul 11, 2026
abcbf95
Keep fallback SEO redirects loop-free
lawrencecchen Jul 11, 2026
b803844
Preserve fallback locale negotiation
lawrencecchen Jul 11, 2026
7bbfe14
Keep legal metadata marketing-free
lawrencecchen Jul 11, 2026
4217eb3
Align SEO bounds and canonical links
lawrencecchen Jul 11, 2026
3be4b0f
Emit direct fallback content links
lawrencecchen Jul 11, 2026
2666930
Emit constrained content links directly
lawrencecchen Jul 11, 2026
e0a3c07
Preserve localized metadata boundaries
lawrencecchen Jul 11, 2026
852d77d
Select authored SEO metadata candidates
lawrencecchen Jul 11, 2026
1da54cf
Make SEO width checks deterministic
lawrencecchen Jul 11, 2026
3e0a647
Preserve localized SEO route identity
lawrencecchen Jul 11, 2026
b4d6a4b
Share localized metadata sentence joining
lawrencecchen Jul 11, 2026
5d3bb81
Prefer complete route-specific SEO prose
lawrencecchen Jul 11, 2026
d51d50c
Reject metadata lead-in fragments
lawrencecchen Jul 11, 2026
52659ea
Reject unresolved metadata placeholders
lawrencecchen Jul 11, 2026
ab6ce8f
Keep fallback metadata semantically complete
lawrencecchen Jul 11, 2026
0930130
Use complete localized SEO context
lawrencecchen Jul 11, 2026
a3faf51
Use complete localized SEO context
lawrencecchen Jul 11, 2026
44ac6d5
Preserve useful localized SEO fallbacks
lawrencecchen Jul 11, 2026
300afa6
Avoid invalid localized SEO fallbacks
lawrencecchen Jul 11, 2026
83f475e
Stabilize navigation mocks in web tests
lawrencecchen Jul 11, 2026
101d1ce
Preserve locale preference for fallback content
lawrencecchen Jul 11, 2026
a261994
Normalize fallback SEO paths
lawrencecchen Jul 11, 2026
478a89c
test: cover audited docs metadata
lawrencecchen Jul 11, 2026
2d9bf92
Fix residual docs metadata from audit
lawrencecchen Jul 11, 2026
08220c6
Avoid rich text in docs SEO metadata
lawrencecchen Jul 11, 2026
be5c3d6
Adapt docs SEO candidates to complete prose
lawrencecchen Jul 11, 2026
efe83a3
Classify docs SEO context fragments
lawrencecchen Jul 11, 2026
e889234
test: reject docs metadata placeholders
lawrencecchen Jul 11, 2026
0865b3c
Keep localized docs metadata within bounds
lawrencecchen Jul 11, 2026
42776ba
test: cover docs metadata review regressions
lawrencecchen Jul 11, 2026
488afc9
Fix docs metadata review regressions
lawrencecchen Jul 11, 2026
1747235
test: avoid stacked docs title suffixes
lawrencecchen Jul 11, 2026
18a7afb
Keep templated docs titles within bounds
lawrencecchen Jul 11, 2026
f08ed91
Isolate docs metadata regression coverage
lawrencecchen Jul 11, 2026
5daf6d4
Avoid duplicate branding in docs titles
lawrencecchen Jul 11, 2026
19122f4
test: reject generic docs metadata fallbacks
lawrencecchen Jul 11, 2026
7671030
Keep docs metadata grounded in route copy
lawrencecchen Jul 11, 2026
2834291
test: reject truncated docs metadata
lawrencecchen Jul 11, 2026
cf6f3f6
Use complete raw copy for docs metadata
lawrencecchen Jul 11, 2026
94e7c94
test: keep docs prose attached to subjects
lawrencecchen Jul 11, 2026
3cfb760
Use standalone prose for docs metadata
lawrencecchen Jul 11, 2026
830eac3
test: require audited docs description sources
lawrencecchen Jul 11, 2026
ff04f31
Use audited sources for docs descriptions
lawrencecchen Jul 11, 2026
c81e844
Merge remote-tracking branch 'origin/main' into feat-seo-docs-audit
lawrencecchen Jul 12, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
@@ -1,28 +1,16 @@
import { useTranslations } from "next-intl";
import { getTranslations } from "next-intl/server";
import { CodeBlock } from "@/app/[locale]/components/code-block";
import { DocsHeading } from "@/app/[locale]/components/docs-heading";
import { buildAlternates, openGraphDefaults, seoDescription, twitterSummary } from "@/i18n/seo";
import { auditedDocsMetadata } from "../../audited-docs-metadata";
import { DocsSchema } from "../../docs-schema";

export async function generateMetadata({ params }: { params: Promise<{ locale: string }> }) {
const { locale } = await params;
const t = await getTranslations({ locale, namespace: "docs.ohMyOpenCode" });
const alternates = buildAlternates(locale, "/docs/agent-integrations/oh-my-opencode");
const title = t("metaTitle");
const description = seoDescription(locale, t("metaDescription"));
return {
title,
description,
alternates,
openGraph: {
...openGraphDefaults(locale, "article"),
title,
description,
url: alternates.canonical,
},
twitter: twitterSummary(locale, title, description),
};
return auditedDocsMetadata({
locale,
pageKey: "ohMyOpenCode",
path: "/docs/agent-integrations/oh-my-opencode",
});
}

export default function OhMyOpenCodePage() {
Expand Down
24 changes: 6 additions & 18 deletions web/app/[locale]/(landing)/docs/api/page.tsx
Original file line number Diff line number Diff line change
@@ -1,29 +1,17 @@
import { useTranslations } from "next-intl";
import { getTranslations } from "next-intl/server";
import { buildAlternates, openGraphDefaults, seoDescription, twitterSummary } from "@/i18n/seo";
import { auditedDocsMetadata } from "../audited-docs-metadata";
import { DocsSchema } from "../docs-schema";
import { CodeBlock } from "@/app/[locale]/components/code-block";
import { Callout } from "@/app/[locale]/components/callout";
import { DocsHeading } from "@/app/[locale]/components/docs-heading";

export async function generateMetadata({ params }: { params: Promise<{ locale: string }> }) {
const { locale } = await params;
const t = await getTranslations({ locale, namespace: "docs.api" });
const alternates = buildAlternates(locale, "/docs/api");
const title = t("metaTitle");
const description = seoDescription(locale, t("metaDescription"));
return {
title,
description,
alternates,
openGraph: {
...openGraphDefaults(locale, "article"),
title,
description,
url: alternates.canonical,
},
twitter: twitterSummary(locale, title, description),
};
return auditedDocsMetadata({
locale,
pageKey: "api",
path: "/docs/api",
});
}

function Cmd({
Expand Down
68 changes: 68 additions & 0 deletions web/app/[locale]/(landing)/docs/audited-docs-metadata.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1,68 @@
import { getMessages } from "next-intl/server";
import type { Locale } from "@/i18n/routing";
import {
type AuditedDocsPageKey,
docsPageSeoCopy,
type SeoMessageLookup,
} from "@/i18n/audited-seo";
import {
buildAlternates,
openGraphDefaults,
twitterSummary,
} from "@/i18n/seo";

export async function auditedDocsMetadata({
locale,
pageKey,
path,
availableLocales,
}: {
locale: string;
pageKey: AuditedDocsPageKey;
path: string;
availableLocales?: readonly Locale[];
}) {
const allMessages = await getMessages({ locale });
const docs = allMessages.docs as Record<string, unknown>;
const pageMessages = docs[pageKey] as Record<string, unknown>;
const messages: SeoMessageLookup = (key) => {
const value = pageMessages[key];
if (typeof value !== "string") {
throw new Error(`Expected docs.${pageKey}.${key} to be a string`);
}
return value;
};
const layoutTitle = docs.layoutTitle;
if (typeof layoutTitle !== "string") {
throw new Error("Expected docs.layoutTitle to be a string");
}
const alternates = buildAlternates(locale, path, availableLocales);
const { title, socialTitle, description } = docsPageSeoCopy(
locale,
pageKey,
messages,
layoutTitle,
{
curatedDescription:
typeof pageMessages.metaDescriptionShort === "string"
? pageMessages.metaDescriptionShort
: undefined,
intro:
typeof pageMessages.intro === "string"
? pageMessages.intro
: undefined,
},
);
return {
title,
description,
Comment thread
cursor[bot] marked this conversation as resolved.
Resolved
alternates,
openGraph: {
...openGraphDefaults(locale, "article"),
title: socialTitle,
description,
url: alternates.canonical,
},
twitter: twitterSummary(locale, socialTitle, description),
};
}
24 changes: 6 additions & 18 deletions web/app/[locale]/(landing)/docs/browser-automation/page.tsx
Original file line number Diff line number Diff line change
@@ -1,28 +1,16 @@
import { useTranslations } from "next-intl";
import { getTranslations } from "next-intl/server";
import { buildAlternates, openGraphDefaults, seoDescription, twitterSummary } from "@/i18n/seo";
import { auditedDocsMetadata } from "../audited-docs-metadata";
import { DocsSchema } from "../docs-schema";
import { CodeBlock } from "@/app/[locale]/components/code-block";
import { DocsHeading } from "@/app/[locale]/components/docs-heading";

export async function generateMetadata({ params }: { params: Promise<{ locale: string }> }) {
const { locale } = await params;
const t = await getTranslations({ locale, namespace: "docs.browserAutomation" });
const alternates = buildAlternates(locale, "/docs/browser-automation");
const title = t("metaTitle");
const description = seoDescription(locale, t("metaDescription"));
return {
title,
description,
alternates,
openGraph: {
...openGraphDefaults(locale, "article"),
title,
description,
url: alternates.canonical,
},
twitter: twitterSummary(locale, title, description),
};
return auditedDocsMetadata({
locale,
pageKey: "browserAutomation",
path: "/docs/browser-automation",
});
}

export default function BrowserAutomationPage() {
Expand Down
24 changes: 6 additions & 18 deletions web/app/[locale]/(landing)/docs/concepts/page.tsx
Original file line number Diff line number Diff line change
@@ -1,29 +1,17 @@
import { useTranslations } from "next-intl";
import { getTranslations } from "next-intl/server";
import { buildAlternates, openGraphDefaults, seoDescription, twitterSummary } from "@/i18n/seo";
import { auditedDocsMetadata } from "../audited-docs-metadata";
import { DocsSchema } from "../docs-schema";
import { Link } from "@/i18n/navigation";
import { CodeBlock } from "@/app/[locale]/components/code-block";
import { DocsHeading } from "@/app/[locale]/components/docs-heading";

export async function generateMetadata({ params }: { params: Promise<{ locale: string }> }) {
const { locale } = await params;
const t = await getTranslations({ locale, namespace: "docs.concepts" });
const alternates = buildAlternates(locale, "/docs/concepts");
const title = t("metaTitle");
const description = seoDescription(locale, t("metaDescription"));
return {
title,
description,
alternates,
openGraph: {
...openGraphDefaults(locale, "article"),
title,
description,
url: alternates.canonical,
},
twitter: twitterSummary(locale, title, description),
};
return auditedDocsMetadata({
locale,
pageKey: "concepts",
path: "/docs/concepts",
});
}

export default function ConceptsPage() {
Expand Down
24 changes: 6 additions & 18 deletions web/app/[locale]/(landing)/docs/configuration/page.tsx
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
import { useLocale, useTranslations } from "next-intl";
import { getTranslations } from "next-intl/server";
import { buildAlternates, openGraphDefaults, seoDescription, twitterSummary } from "@/i18n/seo";
import { auditedDocsMetadata } from "../audited-docs-metadata";
import { DocsSchema } from "../docs-schema";
import { Link } from "@/i18n/navigation";
import { CodeBlock } from "@/app/[locale]/components/code-block";
Expand Down Expand Up @@ -151,22 +150,11 @@ function buildSettingsFileExample(t: ConfigurationTranslation) {

export async function generateMetadata({ params }: { params: Promise<{ locale: string }> }) {
const { locale } = await params;
const t = await getTranslations({ locale, namespace: "docs.configuration" });
const alternates = buildAlternates(locale, "/docs/configuration");
const title = t("metaTitle");
const description = seoDescription(locale, t("metaDescription"));
return {
title,
description,
alternates,
openGraph: {
...openGraphDefaults(locale, "article"),
title,
description,
url: alternates.canonical,
},
twitter: twitterSummary(locale, title, description),
};
return auditedDocsMetadata({
locale,
pageKey: "configuration",
path: "/docs/configuration",
});
}

function shortcutToConfig(shortcut: { combos: string[][]; configValue?: string }) {
Expand Down
24 changes: 6 additions & 18 deletions web/app/[locale]/(landing)/docs/custom-commands/page.tsx
Original file line number Diff line number Diff line change
@@ -1,7 +1,6 @@
import type { ReactNode } from "react";
import { useTranslations } from "next-intl";
import { getTranslations } from "next-intl/server";
import { buildAlternates, openGraphDefaults, seoDescription, twitterSummary } from "@/i18n/seo";
import { auditedDocsMetadata } from "../audited-docs-metadata";
import { DocsSchema } from "../docs-schema";
import { CodeBlock } from "@/app/[locale]/components/code-block";
import { Callout } from "@/app/[locale]/components/callout";
Expand Down Expand Up @@ -41,22 +40,11 @@ function inlineCode(chunks: string, key: number) {

export async function generateMetadata({ params }: { params: Promise<{ locale: string }> }) {
const { locale } = await params;
const t = await getTranslations({ locale, namespace: "docs.customCommands" });
const alternates = buildAlternates(locale, "/docs/custom-commands");
const title = t("metaTitle");
const description = seoDescription(locale, t("metaDescription"));
return {
title,
description,
alternates,
openGraph: {
...openGraphDefaults(locale, "article"),
title,
description,
url: alternates.canonical,
},
twitter: twitterSummary(locale, title, description),
};
return auditedDocsMetadata({
locale,
pageKey: "customCommands",
path: "/docs/custom-commands",
});
}

export default function CustomCommandsPage() {
Expand Down
24 changes: 6 additions & 18 deletions web/app/[locale]/(landing)/docs/dock/page.tsx
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
import { useTranslations } from "next-intl";
import { getTranslations } from "next-intl/server";
import { buildAlternates, openGraphDefaults, seoDescription, twitterSummary } from "@/i18n/seo";
import { auditedDocsMetadata } from "../audited-docs-metadata";
import { DocsSchema } from "../docs-schema";
import { CodeBlock } from "@/app/[locale]/components/code-block";
import { Callout } from "@/app/[locale]/components/callout";
Expand All @@ -12,22 +11,11 @@ export async function generateMetadata({
params: Promise<{ locale: string }>;
}) {
const { locale } = await params;
const t = await getTranslations({ locale, namespace: "docs.dock" });
const alternates = buildAlternates(locale, "/docs/dock");
const title = t("metaTitle");
const description = seoDescription(locale, t("metaDescription"));
return {
title,
description,
alternates,
openGraph: {
...openGraphDefaults(locale, "article"),
title,
description,
url: alternates.canonical,
},
twitter: twitterSummary(locale, title, description),
};
return auditedDocsMetadata({
locale,
pageKey: "dock",
path: "/docs/dock",
});
}

export default function DockPage() {
Expand Down
24 changes: 6 additions & 18 deletions web/app/[locale]/(landing)/docs/getting-started/page.tsx
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
import { useTranslations } from "next-intl";
import { getTranslations } from "next-intl/server";
import { buildAlternates, openGraphDefaults, seoDescription, twitterSummary } from "@/i18n/seo";
import { auditedDocsMetadata } from "../audited-docs-metadata";
import { DocsSchema } from "../docs-schema";
import { Link } from "@/i18n/navigation";
import { CodeBlock } from "@/app/[locale]/components/code-block";
Expand All @@ -10,22 +9,11 @@ import { DocsHeading } from "@/app/[locale]/components/docs-heading";

export async function generateMetadata({ params }: { params: Promise<{ locale: string }> }) {
const { locale } = await params;
const t = await getTranslations({ locale, namespace: "docs.gettingStarted" });
const alternates = buildAlternates(locale, "/docs/getting-started");
const title = t("metaTitle");
const description = seoDescription(locale, t("metaDescription"));
return {
title,
description,
alternates,
openGraph: {
...openGraphDefaults(locale, "article"),
title,
description,
url: alternates.canonical,
},
twitter: twitterSummary(locale, title, description),
};
return auditedDocsMetadata({
locale,
pageKey: "gettingStarted",
path: "/docs/getting-started",
});
}

export default function GettingStartedPage() {
Expand Down
24 changes: 6 additions & 18 deletions web/app/[locale]/(landing)/docs/ios/page.tsx
Original file line number Diff line number Diff line change
@@ -1,29 +1,17 @@
import { useTranslations } from "next-intl";
import { getTranslations } from "next-intl/server";
import { Link } from "@/i18n/navigation";
import { buildAlternates, openGraphDefaults, seoDescription, twitterSummary } from "@/i18n/seo";
import { auditedDocsMetadata } from "../audited-docs-metadata";
import { DocsSchema } from "../docs-schema";
import { Callout } from "@/app/[locale]/components/callout";
import { DocsHeading } from "@/app/[locale]/components/docs-heading";

export async function generateMetadata({ params }: { params: Promise<{ locale: string }> }) {
const { locale } = await params;
const t = await getTranslations({ locale, namespace: "docs.ios" });
const alternates = buildAlternates(locale, "/docs/ios");
const title = t("metaTitle");
const description = seoDescription(locale, t("metaDescription"));
return {
title,
description,
alternates,
openGraph: {
...openGraphDefaults(locale, "article"),
title,
description,
url: alternates.canonical,
},
twitter: twitterSummary(locale, title, description),
};
return auditedDocsMetadata({
locale,
pageKey: "ios",
path: "/docs/ios",
});
}

const linkClass =
Expand Down
Loading