From 70aaba9b25d3e4ca6c064e17bad5444e4b277da3 Mon Sep 17 00:00:00 2001 From: DABH Date: Thu, 20 Aug 2026 22:54:42 -0500 Subject: [PATCH 1/2] Fix copy-pasted titles and labels on SDK section index pages An audit comparing each docs/develop//
/index.mdx against its directory found frontmatter carried over from whichever page it was copied from: - All 7 platform/index.mdx pages were titled "Client - SDK". The built page rendered "Client - Python SDK" as its H1 while the sidebar entry correctly read "Platform", so clicking Platform landed on a page titled Client. - typescript/activities/index.mdx was titled "Workflows - TypeScript SDK". - typescript/activities and typescript/workflows both described themselves as explaining "how to implement Workers". - java/workers and java/workflows both set sidebar_label: Nexus. sidebars.js sets an explicit label on these categories, so the left nav was already right and only the sidebar_label values were inert. The titles and descriptions were not: they drive the H1, the page title, the OG card, and search snippets. --- docs/develop/dotnet/platform/index.mdx | 4 ++-- docs/develop/go/platform/index.mdx | 4 ++-- docs/develop/java/platform/index.mdx | 4 ++-- docs/develop/java/workers/index.mdx | 2 +- docs/develop/java/workflows/index.mdx | 2 +- docs/develop/php/platform/index.mdx | 4 ++-- docs/develop/python/platform/index.mdx | 4 ++-- docs/develop/ruby/platform/index.mdx | 4 ++-- docs/develop/typescript/activities/index.mdx | 7 +++---- docs/develop/typescript/platform/index.mdx | 4 ++-- docs/develop/typescript/workflows/index.mdx | 3 +-- 11 files changed, 20 insertions(+), 22 deletions(-) diff --git a/docs/develop/dotnet/platform/index.mdx b/docs/develop/dotnet/platform/index.mdx index 7ff6f3e3c5..c181df4926 100644 --- a/docs/develop/dotnet/platform/index.mdx +++ b/docs/develop/dotnet/platform/index.mdx @@ -1,7 +1,7 @@ --- id: index -title: Client - .NET SDK -sidebar_label: Client +title: Platform - .NET SDK +sidebar_label: Platform description: This section explains how to implement platform with the .NET SDK toc_max_heading_level: 4 keywords: diff --git a/docs/develop/go/platform/index.mdx b/docs/develop/go/platform/index.mdx index 5bf6d49680..38d83d7135 100644 --- a/docs/develop/go/platform/index.mdx +++ b/docs/develop/go/platform/index.mdx @@ -1,7 +1,7 @@ --- id: index -title: Client - Go SDK -sidebar_label: Client +title: Platform - Go SDK +sidebar_label: Platform description: This section explains how to implement platform with the Go SDK toc_max_heading_level: 4 keywords: diff --git a/docs/develop/java/platform/index.mdx b/docs/develop/java/platform/index.mdx index b92a13802f..6c1e483b9c 100644 --- a/docs/develop/java/platform/index.mdx +++ b/docs/develop/java/platform/index.mdx @@ -1,7 +1,7 @@ --- id: index -title: Client - Java SDK -sidebar_label: Client +title: Platform - Java SDK +sidebar_label: Platform description: This section explains how to implement platform with the Java SDK toc_max_heading_level: 4 keywords: diff --git a/docs/develop/java/workers/index.mdx b/docs/develop/java/workers/index.mdx index 57b54e17b4..fd1ebb9e16 100644 --- a/docs/develop/java/workers/index.mdx +++ b/docs/develop/java/workers/index.mdx @@ -1,7 +1,7 @@ --- id: index title: Workers - Java SDK -sidebar_label: Nexus +sidebar_label: Workers description: This section covers Workers with the Java SDK toc_max_heading_level: 4 keywords: diff --git a/docs/develop/java/workflows/index.mdx b/docs/develop/java/workflows/index.mdx index dbb4856a60..6fcd477fee 100644 --- a/docs/develop/java/workflows/index.mdx +++ b/docs/develop/java/workflows/index.mdx @@ -1,7 +1,7 @@ --- id: index title: Workflows - Java SDK -sidebar_label: Nexus +sidebar_label: Workflows description: This section covers Workflows with the Java SDK toc_max_heading_level: 4 keywords: diff --git a/docs/develop/php/platform/index.mdx b/docs/develop/php/platform/index.mdx index c405c1fa7d..4769fcfea1 100644 --- a/docs/develop/php/platform/index.mdx +++ b/docs/develop/php/platform/index.mdx @@ -1,7 +1,7 @@ --- id: index -title: Client - PHP SDK -sidebar_label: Client +title: Platform - PHP SDK +sidebar_label: Platform description: This section explains how to implement platform with the PHP SDK toc_max_heading_level: 4 keywords: diff --git a/docs/develop/python/platform/index.mdx b/docs/develop/python/platform/index.mdx index 80b03ba25c..93261aa631 100644 --- a/docs/develop/python/platform/index.mdx +++ b/docs/develop/python/platform/index.mdx @@ -1,7 +1,7 @@ --- id: index -title: Client - Python SDK -sidebar_label: Client +title: Platform - Python SDK +sidebar_label: Platform description: This section explains how to implement platform with the Python SDK toc_max_heading_level: 4 keywords: diff --git a/docs/develop/ruby/platform/index.mdx b/docs/develop/ruby/platform/index.mdx index 8fed7ccccf..7c77d527f1 100644 --- a/docs/develop/ruby/platform/index.mdx +++ b/docs/develop/ruby/platform/index.mdx @@ -1,7 +1,7 @@ --- id: index -title: Client - Ruby SDK -sidebar_label: Client +title: Platform - Ruby SDK +sidebar_label: Platform description: This section explains how to implement platform with the Ruby SDK toc_max_heading_level: 4 keywords: diff --git a/docs/develop/typescript/activities/index.mdx b/docs/develop/typescript/activities/index.mdx index 719893172d..7b29878a51 100644 --- a/docs/develop/typescript/activities/index.mdx +++ b/docs/develop/typescript/activities/index.mdx @@ -1,9 +1,8 @@ --- id: index -title: Workflows - TypeScript SDK -sidebar_label: Workflows -description: - This section explains how to implement Workers with the TypeScript SDK +title: Activities - TypeScript SDK +sidebar_label: Activities +description: This section explains how to implement Activities with the TypeScript SDK toc_max_heading_level: 4 keywords: - typescript diff --git a/docs/develop/typescript/platform/index.mdx b/docs/develop/typescript/platform/index.mdx index 9a32c58aeb..63c8c979f4 100644 --- a/docs/develop/typescript/platform/index.mdx +++ b/docs/develop/typescript/platform/index.mdx @@ -1,7 +1,7 @@ --- id: index -title: Client - TypeScript SDK -sidebar_label: Client +title: Platform - TypeScript SDK +sidebar_label: Platform description: This section explains how to implement platform with the TypeScript SDK toc_max_heading_level: 4 keywords: diff --git a/docs/develop/typescript/workflows/index.mdx b/docs/develop/typescript/workflows/index.mdx index ea13f214b8..c169f5116f 100644 --- a/docs/develop/typescript/workflows/index.mdx +++ b/docs/develop/typescript/workflows/index.mdx @@ -2,8 +2,7 @@ id: index title: Workflows - TypeScript SDK sidebar_label: Workflows -description: - This section explains how to implement Workers with the TypeScript SDK +description: This section explains how to implement Workflows with the TypeScript SDK toc_max_heading_level: 4 keywords: - typescript From 2aa3ecc5d859cb6802335ab2c23b95b713423808 Mon Sep 17 00:00:00 2001 From: DABH Date: Thu, 20 Aug 2026 23:06:48 -0500 Subject: [PATCH 2/2] Fix a fourth copy-pasted description docs/develop/java/activities/timeouts.mdx described itself as explaining "how to implement Workers". Widening the audit from index.mdx to every page under docs/develop found it; the first pass only checked index pages. --- docs/develop/java/activities/timeouts.mdx | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/docs/develop/java/activities/timeouts.mdx b/docs/develop/java/activities/timeouts.mdx index 5dd11d8328..e01b73033b 100644 --- a/docs/develop/java/activities/timeouts.mdx +++ b/docs/develop/java/activities/timeouts.mdx @@ -2,8 +2,7 @@ id: timeouts title: Activity Timeouts - Java SDK sidebar_label: Timeouts -description: - This section explains how to implement Workers with the Java SDK +description: This section explains how to set Activity Timeouts with the Java SDK toc_max_heading_level: 4 keywords: - java