From 27d82d8cfbc9ea5ed3294e916d5cc652e23fa3d0 Mon Sep 17 00:00:00 2001
From: DABH <DABH@users.noreply.github.com>
Date: Thu, 20 Aug 2026 22:52:20 -0500
Subject: [PATCH 1/5] WIP: prototype insert-only sidebar link list generator
 for #5144

---
 bin/generate-sidebar-link-lists.js      | 400 ++++++++++++++++++++++++
 bin/generate-sidebar-link-lists.test.js | 118 +++++++
 docs/develop/python/workers/index.mdx   |   3 +
 package.json                            |   2 +
 4 files changed, 523 insertions(+)
 create mode 100644 bin/generate-sidebar-link-lists.js
 create mode 100644 bin/generate-sidebar-link-lists.test.js

diff --git a/bin/generate-sidebar-link-lists.js b/bin/generate-sidebar-link-lists.js
new file mode 100644
index 0000000000..fbe6eba230
--- /dev/null
+++ b/bin/generate-sidebar-link-lists.js
@@ -0,0 +1,400 @@
+#!/usr/bin/env node
+
+// Generates the "here's what's in this section" link lists that SDK landing
+// pages and section index pages carry, from sidebars.js — the same source
+// Docusaurus builds the left nav from.
+//
+// Those lists are hand-maintained today, which is why they drift: adding a
+// page wires it into sidebars.js but nothing updates the prose lists that
+// duplicate it. See https://github.com/temporalio/documentation/issues/5144.
+//
+// Only regions wrapped in markers are touched, so a page opts in per list and
+// everything around the markers stays hand-written:
+//
+//   {/* SIDEBAR-LIST-START */}
+//   - [Workflow basics](/develop/python/workflows/basics)
+//   {/* SIDEBAR-LIST-END */}
+//
+// With no attribute the region renders the direct children of whichever
+// sidebar category links to *this* page — the section-index-page case. A
+// landing page carries several lists, one per section, so those name it:
+//
+//   {/* SIDEBAR-LIST-START section="Workflows" */}
+//
+// Markers are MDX expression comments, so the LLM markdown pipeline
+// (scripts/mdx-to-md.mjs) already strips them while the generated bullets
+// survive as ordinary Markdown. That's the reason for generating text in
+// place rather than rendering a React component: a component would need a
+// parallel handler in scripts/component-handlers/ to avoid blanking these
+// links in llms-full.txt and the per-page .md files, the way an unwired
+// <GuidesGrid /> currently blanks the guides catalog.
+//
+//   node bin/generate-sidebar-link-lists.js           # rewrite in place
+//   node bin/generate-sidebar-link-lists.js --check    # CI: fail if stale
+//   node bin/generate-sidebar-link-lists.js --json     # machine-readable
+//   node bin/generate-sidebar-link-lists.js --list     # marker inventory
+//
+// Exit codes: 0 clean, 2 stale regions (--check) or an unresolvable marker.
+
+const fs = require('fs');
+const path = require('path');
+const matter = require('gray-matter');
+
+const { walkDir, resolveUrlPath } = require('../plugins/shared/docsRouting');
+const { isExcludedDocPath } = require('./check-orphan-pages');
+
+const DOCS_DIR = path.join(process.cwd(), 'docs');
+const SIDEBARS_FILE = path.join(process.cwd(), 'sidebars.js');
+
+const START = /^(\s*)\{\/\*\s*SIDEBAR-LIST-START(?<attrs>[^*]*?)\*\/\}\s*$/;
+const END = /^\s*\{\/\*\s*SIDEBAR-LIST-END\s*\*\/\}\s*$/;
+
+// ---------------------------------------------------------------------------
+// Doc index: every routed doc file, keyed by the doc id sidebars.js uses
+// ---------------------------------------------------------------------------
+
+// Mirrors bin/check-orphan-pages.js's computeDocId: an index file's id keeps
+// the literal "index" segment, because that's how sidebars.js addresses it.
+function computeDocId(filePath) {
+  const rel = path.relative(DOCS_DIR, filePath).replace(/\\/g, '/');
+  const withoutExt = rel.replace(/\.(md|mdx)$/i, '');
+  const dir = path.dirname(withoutExt);
+  const base = path.basename(withoutExt);
+  return dir === '.' ? base : `${dir}/${base}`;
+}
+
+function buildDocIndex() {
+  const byId = new Map();
+  for (const filePath of walkDir(DOCS_DIR)) {
+    const rel = path.relative(DOCS_DIR, filePath);
+    if (isExcludedDocPath(rel)) continue;
+
+    const { data } = matter(fs.readFileSync(filePath, 'utf8'));
+    const id = data.id && !data.id.includes('/')
+      // A frontmatter `id` renames only the last segment; sidebars.js still
+      // addresses the file by its directory path.
+      ? [path.dirname(computeDocId(filePath)), data.id].filter((s) => s !== '.').join('/')
+      : computeDocId(filePath);
+
+    byId.set(id, {
+      filePath,
+      url: `/${resolveUrlPath(DOCS_DIR, filePath, data)}`,
+      // Docusaurus falls back title -> sidebar_label for nav text; a `label`
+      // in sidebars.js overrides both and is applied by resolveItem below.
+      label: data.sidebar_label || data.title || path.basename(id),
+      draft: data.draft === true,
+      unlisted: data.unlisted === true,
+    });
+  }
+  return byId;
+}
+
+// ---------------------------------------------------------------------------
+// Sidebar tree, resolved to {label, url} the way the rendered nav resolves it
+// ---------------------------------------------------------------------------
+
+function resolveItem(item, docs) {
+  if (typeof item === 'string') {
+    const doc = docs.get(item);
+    return doc ? { kind: 'doc', id: item, label: doc.label, url: doc.url } : null;
+  }
+  if (!item || typeof item !== 'object') return null;
+
+  if (item.type === 'doc' && item.id) {
+    const doc = docs.get(item.id);
+    if (!doc) return null;
+    return { kind: 'doc', id: item.id, label: item.label || doc.label, url: doc.url };
+  }
+  if (item.type === 'link' && item.href) {
+    return { kind: 'link', label: item.label, url: item.href, external: true };
+  }
+  if (item.type === 'category') {
+    const linkId = item.link && item.link.type === 'doc' ? item.link.id : item.link && item.link.id;
+    const doc = linkId ? docs.get(linkId) : null;
+    return {
+      kind: 'category',
+      label: item.label,
+      url: doc ? doc.url : null,
+      linkId: linkId || null,
+      children: (item.items || []).map((child) => resolveItem(child, docs)).filter(Boolean),
+    };
+  }
+  return null;
+}
+
+function buildSidebarTree(docs) {
+  // sidebars.js is plain CommonJS and already require()s src/constants, so
+  // requiring it gives the real config rather than a regex approximation.
+  const sidebars = require(SIDEBARS_FILE);
+  return Object.values(sidebars)
+    .flat()
+    .map((item) => resolveItem(item, docs))
+    .filter(Boolean);
+}
+
+function eachCategory(nodes, visit) {
+  for (const node of nodes) {
+    if (node.kind !== 'category') continue;
+    visit(node);
+    eachCategory(node.children, visit);
+  }
+}
+
+// The category a page "owns" is the one whose link points at that page.
+function findOwningCategory(tree, docId) {
+  let found = null;
+  eachCategory(tree, (cat) => {
+    if (!found && cat.linkId === docId) found = cat;
+  });
+  return found;
+}
+
+function findNamedDescendant(category, label) {
+  let found = null;
+  eachCategory(category.children, (cat) => {
+    if (!found && cat.label === label) found = cat;
+  });
+  return found;
+}
+
+// ---------------------------------------------------------------------------
+// Rendering
+// ---------------------------------------------------------------------------
+
+// A category may have no `link` of its own (Standalone Activities, for one).
+// Docusaurus renders those by falling back to the first descendant that does
+// have a link — mirror that instead of dropping the entry, so a category can
+// never silently vanish from a generated list.
+function firstLink(node) {
+  if (node.url) return node.url;
+  for (const child of node.children || []) {
+    const url = firstLink(child);
+    if (url) return url;
+  }
+  return null;
+}
+
+// One level only, matching what the pages express today: a nested category
+// renders as a single link rather than being flattened, which is what keeps
+// depth-4 pages (serverless-workers/*, data-handling/*) off the landing pages.
+function renderList(category, indent) {
+  return category.children.map((child) => {
+    const url = firstLink(child);
+    if (!url) {
+      // Refusing here rather than omitting: a silently shorter list is the
+      // failure mode this script exists to prevent.
+      throw new Error(`sidebar item "${child.label}" under "${category.label}" has no resolvable link, so it cannot be rendered`);
+    }
+    return `${indent}- [${child.label}](${url})`;
+  });
+}
+
+const BULLET = /^\s*-\s*\[(?<label>[^\]]+)\]\((?<url>[^)]+)\)\s*$/;
+
+// Reconciles a marker region against the sidebar rather than overwriting it.
+//
+// The sidebar decides which pages appear and in what order — that's the drift
+// this script exists to kill. It deliberately does NOT decide the link text:
+// sidebar labels disagree with these lists on 37 links, some of them against
+// the sentence-case rule in readme/STYLE.md ("Feature guide" -> "Feature
+// Guide"), and two SDKs disagree with each other on the same page. Importing
+// that into prose would trade a drift problem for a copy problem.
+//
+// So: an entry already present keeps its hand-written text, a missing entry is
+// added using the sidebar label as a starting point, and a line whose URL
+// isn't in this category at all (an external tutorial link, say) is preserved
+// rather than deleted.
+function reconcileList(category, existingLines, indent) {
+  const existing = [];
+  for (const line of existingLines) {
+    const m = line.match(BULLET);
+    if (m) existing.push({ line, url: m.groups.url, label: m.groups.label });
+    else if (line.trim() !== '') existing.push({ line, url: null, label: null });
+  }
+
+  const generated = renderList(category, indent).map((line) => {
+    const m = line.match(BULLET);
+    return { line, url: m.groups.url, label: m.groups.label };
+  });
+  const sidebarUrls = new Set(generated.map((g) => g.url));
+
+  // Insert-only, deliberately. Reordering and relabelling 52 pages to fix 5
+  // genuine gaps is a bad trade: the sidebar's order and labels are no better
+  // than the prose's (37 label disagreements, some against readme/STYLE.md),
+  // and a purely additive diff is the one a reviewer can actually check. So
+  // existing lines keep their text AND their position; only missing entries
+  // are inserted, each after whichever sidebar sibling precedes it.
+  const existingUrls = new Set(existing.map((e) => e.url).filter(Boolean));
+  const out = existing.map((e) => e.line);
+  const added = [];
+
+  generated.forEach((g, gi) => {
+    if (existingUrls.has(g.url)) return;
+
+    // Anchor to the nearest earlier sidebar sibling that the page already
+    // lists, so a new entry lands next to its neighbours rather than at the
+    // bottom.
+    let at = 0;
+    for (let i = gi - 1; i >= 0; i -= 1) {
+      const idx = out.findIndex((line) => {
+        const m = line.match(BULLET);
+        return m && m.groups.url === generated[i].url;
+      });
+      if (idx !== -1) {
+        at = idx + 1;
+        break;
+      }
+    }
+    out.splice(at, 0, g.line);
+    added.push(g.url);
+  });
+
+  return { lines: out, added, preserved: existing.length - sidebarUrls.size };
+}
+
+function parseAttrs(raw) {
+  const attrs = {};
+  for (const m of String(raw || '').matchAll(/(\w+)="([^"]*)"/g)) attrs[m[1]] = m[2];
+  return attrs;
+}
+
+// Returns {lines, regions:[{start,end,section,expected,actual,stale}]}
+function processFile(filePath, tree, docs) {
+  const original = fs.readFileSync(filePath, 'utf8');
+  const eol = original.includes('\r\n') ? '\r\n' : '\n';
+  const lines = original.split(/\r?\n/);
+  const docId = computeDocId(filePath);
+  const regions = [];
+  const out = [];
+
+  for (let i = 0; i < lines.length; i += 1) {
+    const startMatch = lines[i].match(START);
+    if (!startMatch) {
+      out.push(lines[i]);
+      continue;
+    }
+
+    let close = i + 1;
+    while (close < lines.length && !END.test(lines[close])) close += 1;
+    if (close >= lines.length) {
+      throw new Error(`${path.relative(process.cwd(), filePath)}: SIDEBAR-LIST-START at line ${i + 1} has no matching SIDEBAR-LIST-END`);
+    }
+
+    const indent = startMatch[1] || '';
+    const { section } = parseAttrs(startMatch.groups.attrs);
+    const owning = findOwningCategory(tree, docId);
+    if (!owning) {
+      throw new Error(`${path.relative(process.cwd(), filePath)}: no sidebars.js category links to this page (doc id "${docId}"), so a sidebar list cannot be resolved`);
+    }
+    const target = section ? findNamedDescendant(owning, section) : owning;
+    if (!target) {
+      throw new Error(`${path.relative(process.cwd(), filePath)}: no category labelled "${section}" under "${owning.label}"`);
+    }
+
+    const actual = lines.slice(i + 1, close).filter((l) => l.trim() !== '');
+    const { lines: expected, added, preserved } = reconcileList(target, actual, indent);
+    regions.push({
+      section: section || owning.label,
+      line: i + 1,
+      expected,
+      actual,
+      added,
+      preserved,
+      stale: actual.join('\n') !== expected.join('\n'),
+    });
+
+    out.push(lines[i], ...expected, lines[close]);
+    i = close;
+  }
+
+  return { content: out.join(eol), regions, changed: out.join(eol) !== original };
+}
+
+// ---------------------------------------------------------------------------
+// CLI
+// ---------------------------------------------------------------------------
+
+function filesWithMarkers() {
+  return walkDir(DOCS_DIR).filter((f) => {
+    const rel = path.relative(DOCS_DIR, f);
+    if (isExcludedDocPath(rel)) return false;
+    return /SIDEBAR-LIST-START/.test(fs.readFileSync(f, 'utf8'));
+  });
+}
+
+function main(argv) {
+  const check = argv.includes('--check');
+  const asJson = argv.includes('--json');
+  const listOnly = argv.includes('--list');
+
+  const docs = buildDocIndex();
+  const tree = buildSidebarTree(docs);
+  const files = filesWithMarkers();
+
+  if (listOnly) {
+    console.log(`${files.length} file(s) with sidebar-list markers:`);
+    for (const f of files) console.log(`  ${path.relative(process.cwd(), f)}`);
+    return 0;
+  }
+
+  const results = [];
+  for (const filePath of files) {
+    const { content, regions, changed } = processFile(filePath, tree, docs);
+    results.push({ file: path.relative(process.cwd(), filePath), regions, changed });
+    if (!check && changed) fs.writeFileSync(filePath, content);
+  }
+
+  const stale = results.flatMap((r) => r.regions.filter((x) => x.stale).map((x) => ({ ...x, file: r.file })));
+
+  if (asJson) {
+    console.log(JSON.stringify({ files: results.length, stale }, null, 2));
+    return stale.length && check ? 2 : 0;
+  }
+
+  if (!files.length) {
+    console.log('No sidebar-list markers found. Nothing to do.');
+    return 0;
+  }
+
+  if (check) {
+    if (!stale.length) {
+      console.log(`Sidebar link lists are up to date (${results.length} file(s) checked).`);
+      return 0;
+    }
+    console.error(`${stale.length} sidebar link list(s) are out of date:\n`);
+    for (const s of stale) {
+      console.error(`  ${s.file}:${s.line}  [${s.section}]`);
+      for (const line of s.actual.filter((l) => !s.expected.includes(l))) console.error(`    - ${line.trim()}`);
+      for (const line of s.expected.filter((l) => !s.actual.includes(l))) console.error(`    + ${line.trim()}`);
+      console.error('');
+    }
+    console.error('Run `yarn sidebar-links` to update them.');
+    return 2;
+  }
+
+  const rewritten = results.filter((r) => r.changed);
+  console.log(`Generated ${results.reduce((n, r) => n + r.regions.length, 0)} list(s) across ${results.length} file(s); ${rewritten.length} file(s) rewritten.`);
+  for (const r of rewritten) console.log(`  updated ${r.file}`);
+  return 0;
+}
+
+if (require.main === module) {
+  try {
+    process.exit(main(process.argv.slice(2)));
+  } catch (err) {
+    console.error(err.message);
+    process.exit(2);
+  }
+}
+
+module.exports = {
+  buildDocIndex,
+  buildSidebarTree,
+  processFile,
+  findOwningCategory,
+  findNamedDescendant,
+  renderList,
+  reconcileList,
+  firstLink,
+  computeDocId,
+};
diff --git a/bin/generate-sidebar-link-lists.test.js b/bin/generate-sidebar-link-lists.test.js
new file mode 100644
index 0000000000..092851ec50
--- /dev/null
+++ b/bin/generate-sidebar-link-lists.test.js
@@ -0,0 +1,118 @@
+const test = require('node:test');
+const assert = require('node:assert');
+
+const {
+  reconcileList,
+  firstLink,
+  buildDocIndex,
+  buildSidebarTree,
+  findOwningCategory,
+} = require('./generate-sidebar-link-lists');
+
+// Synthetic categories keep these cases stable as the real docs change.
+const cat = (label, children) => ({ kind: 'category', label, url: null, children });
+const doc = (label, url) => ({ kind: 'doc', label, url });
+const link = (label, url) => ({ kind: 'link', label, url, external: true });
+
+test('adds a missing sidebar entry next to its sibling, not at the end', () => {
+  const category = cat('Workers', [
+    doc('Run a Worker', '/develop/python/workers/run-worker-process'),
+    doc('Serverless Workers', '/develop/python/workers/serverless-workers'),
+    doc('Interceptors', '/develop/python/workers/interceptors'),
+  ]);
+  const existing = [
+    '- [Worker processes](/develop/python/workers/run-worker-process)',
+    '- [Interceptors](/develop/python/workers/interceptors)',
+  ];
+
+  const { lines, added } = reconcileList(category, existing, '');
+
+  assert.deepStrictEqual(added, ['/develop/python/workers/serverless-workers']);
+  assert.deepStrictEqual(lines, [
+    // Hand-written "Worker processes" survives; the sidebar's "Run a Worker" does not win.
+    '- [Worker processes](/develop/python/workers/run-worker-process)',
+    '- [Serverless Workers](/develop/python/workers/serverless-workers)',
+    '- [Interceptors](/develop/python/workers/interceptors)',
+  ]);
+});
+
+test('never rewrites the label of an entry that is already listed', () => {
+  const category = cat('Best practices', [doc('Data handling', '/develop/java/best-practices/data-handling')]);
+  const existing = ['- [Converters and encryption](/develop/java/best-practices/data-handling)'];
+
+  const { lines, added } = reconcileList(category, existing, '');
+
+  assert.deepStrictEqual(added, []);
+  assert.deepStrictEqual(lines, existing, 'sidebar labels disagree with prose on 37 links; prose wins');
+});
+
+test('preserves a link the sidebar does not know about', () => {
+  // docs/develop/java/nexus/index.mdx carries an external learn.temporal.io
+  // tutorial link inside its section list.
+  const category = cat('Nexus', [doc('Quickstart', '/develop/java/nexus/quickstart')]);
+  const existing = [
+    '- [Quickstart](/develop/java/nexus/quickstart)',
+    '- [Nexus sync tutorial](https://learn.temporal.io/tutorials/nexus/nexus-sync-tutorial/)',
+  ];
+
+  const { lines } = reconcileList(category, existing, '');
+
+  assert.ok(
+    lines.includes('- [Nexus sync tutorial](https://learn.temporal.io/tutorials/nexus/nexus-sync-tutorial/)'),
+    'an external link inside a generated region must survive',
+  );
+  assert.strictEqual(lines.length, 2);
+});
+
+test('is idempotent', () => {
+  const category = cat('Workers', [
+    doc('Run a Worker', '/a'),
+    doc('Serverless Workers', '/b'),
+  ]);
+  const first = reconcileList(category, ['- [Worker processes](/a)'], '').lines;
+  const second = reconcileList(category, first, '').lines;
+  assert.deepStrictEqual(second, first);
+});
+
+test('resolves a category with no link of its own to its first descendant', () => {
+  // "Standalone Activities" has no link:, so Docusaurus falls back to the
+  // first child. Dropping it instead would silently shorten the list.
+  const nested = cat('Standalone Activities', [
+    doc('Quickstart', '/develop/go/activities/standalone-activities-quickstart'),
+    doc('Feature Guide', '/develop/go/activities/standalone-activities'),
+  ]);
+  assert.strictEqual(firstLink(nested), '/develop/go/activities/standalone-activities-quickstart');
+});
+
+test('refuses to render an item with no resolvable link rather than omitting it', () => {
+  const category = cat('Activities', [cat('Empty', [])]);
+  assert.throws(() => reconcileList(category, [], ''), /no resolvable link/);
+});
+
+test('keeps an external sidebar link item', () => {
+  const category = cat('Section', [link('Change log', 'https://temporal.io/change-log')]);
+  const { lines } = reconcileList(category, [], '');
+  assert.deepStrictEqual(lines, ['- [Change log](https://temporal.io/change-log)']);
+});
+
+test('honours the indent of the marker', () => {
+  const category = cat('S', [doc('A', '/a')]);
+  const { lines } = reconcileList(category, [], '  ');
+  assert.deepStrictEqual(lines, ['  - [A](/a)']);
+});
+
+// Integration: the real sidebars.js and docs tree must resolve without
+// throwing, so a malformed sidebar entry fails the test rather than the build.
+test('every SDK section index page resolves to a sidebar category', () => {
+  const docs = buildDocIndex();
+  const tree = buildSidebarTree(docs);
+  const missing = [];
+
+  for (const [id, entry] of docs) {
+    if (!/^develop\/[a-z]+\/[a-z-]+\/index$/.test(id)) continue;
+    if (entry.draft || entry.unlisted) continue;
+    if (!findOwningCategory(tree, id)) missing.push(id);
+  }
+
+  assert.deepStrictEqual(missing, [], 'these pages have no owning sidebar category');
+});
diff --git a/docs/develop/python/workers/index.mdx b/docs/develop/python/workers/index.mdx
index 97cf989250..c0fcc07be9 100644
--- a/docs/develop/python/workers/index.mdx
+++ b/docs/develop/python/workers/index.mdx
@@ -19,5 +19,8 @@ import * as Components from '@site/src/components';
 
 ## Workers
 
+{/* SIDEBAR-LIST-START */}
 - [Worker processes](/develop/python/workers/run-worker-process)
 - [Interceptors](/develop/python/workers/interceptors)
+- [Serverless Workers](/develop/python/workers/serverless-workers)
+{/* SIDEBAR-LIST-END */}
diff --git a/package.json b/package.json
index b3c2873fe0..1db7857441 100644
--- a/package.json
+++ b/package.json
@@ -19,6 +19,8 @@
     "check:metrics": "node ./bin/check-metrics-reference.js",
     "check:metrics:sdks": "node ./bin/check-metrics-against-sdks.js",
     "check:orphans": "node ./bin/check-orphan-pages.js",
+    "check:sidebar-links": "node ./bin/generate-sidebar-link-lists.js --check",
+    "sidebar-links": "node ./bin/generate-sidebar-link-lists.js",
     "test": "node --test",
     "lint": "vale --output=JSON docs/**/**/*.mdx > vale-output.json; vale --output=JSON docs/**/**/*.md > vale-md-output.json",
     "lint:go": "vale docs/develop/go/*.mdx",

From b211dc9183d8e6ea6c38a7f79005a7a83c7ddb43 Mon Sep 17 00:00:00 2001
From: DABH <DABH@users.noreply.github.com>
Date: Thu, 20 Aug 2026 23:05:34 -0500
Subject: [PATCH 2/5] Report pages that hand-maintain a list with no markers

Markers are opt-in, so a green check with low coverage reads as no drift
when it means no coverage. Warn (not fail) about section index pages that
still hand-maintain a link list, so the gap is visible and new pages get
noticed.
---
 bin/generate-sidebar-link-lists.js | 53 +++++++++++++++++++++++++++++-
 1 file changed, 52 insertions(+), 1 deletion(-)

diff --git a/bin/generate-sidebar-link-lists.js b/bin/generate-sidebar-link-lists.js
index fbe6eba230..67ba354239 100644
--- a/bin/generate-sidebar-link-lists.js
+++ b/bin/generate-sidebar-link-lists.js
@@ -322,6 +322,41 @@ function filesWithMarkers() {
   });
 }
 
+// Markers are opt-in, so coverage quietly erodes: add a section index page,
+// don't add markers, and this check stays green while that page drifts. So
+// report pages that look like they should be covered but aren't.
+//
+// A warning, not a failure. A page with real prose is allowed to keep a
+// hand-written list, and the absence of a marker is how it says so — the same
+// reason this needs no baseline file.
+function unmarkedCandidates(tree) {
+  const candidates = [];
+  for (const filePath of walkDir(DOCS_DIR)) {
+    const rel = path.relative(DOCS_DIR, filePath);
+    if (isExcludedDocPath(rel)) continue;
+
+    const posix = rel.replace(/\\/g, '/');
+    if (!posix.startsWith('develop/') || !/\/index\.mdx?$/.test(posix)) continue;
+
+    const text = fs.readFileSync(filePath, 'utf8');
+    if (/SIDEBAR-LIST-START/.test(text)) continue;
+
+    // Only pages that already hand-maintain a list of internal links.
+    const bullets = [...text.matchAll(/^-\s*\[[^\]]+\]\((\/[^)]+)\)\s*$/gm)];
+    if (bullets.length < 2) continue;
+
+    const category = findOwningCategory(tree, computeDocId(filePath));
+    if (!category) continue;
+
+    candidates.push({
+      file: path.relative(process.cwd(), filePath),
+      section: category.label,
+      bullets: bullets.length,
+    });
+  }
+  return candidates;
+}
+
 function main(argv) {
   const check = argv.includes('--check');
   const asJson = argv.includes('--json');
@@ -331,9 +366,13 @@ function main(argv) {
   const tree = buildSidebarTree(docs);
   const files = filesWithMarkers();
 
+  const unmarked = unmarkedCandidates(tree);
+
   if (listOnly) {
     console.log(`${files.length} file(s) with sidebar-list markers:`);
     for (const f of files) console.log(`  ${path.relative(process.cwd(), f)}`);
+    console.log(`\n${unmarked.length} page(s) hand-maintaining a list with no markers:`);
+    for (const c of unmarked) console.log(`  ${c.file}  [${c.section}, ${c.bullets} links]`);
     return 0;
   }
 
@@ -347,7 +386,7 @@ function main(argv) {
   const stale = results.flatMap((r) => r.regions.filter((x) => x.stale).map((x) => ({ ...x, file: r.file })));
 
   if (asJson) {
-    console.log(JSON.stringify({ files: results.length, stale }, null, 2));
+    console.log(JSON.stringify({ files: results.length, stale, unmarked }, null, 2));
     return stale.length && check ? 2 : 0;
   }
 
@@ -356,9 +395,19 @@ function main(argv) {
     return 0;
   }
 
+  // Printed on both paths: a green check with low coverage is the misleading
+  // case this warning exists to prevent.
+  const warnUnmarked = () => {
+    if (!unmarked.length) return;
+    console.error(`\nNote: ${unmarked.length} page(s) still hand-maintain a link list with no markers, so this check does not cover them:`);
+    for (const c of unmarked) console.error(`  ${c.file}  [${c.section}, ${c.bullets} links]`);
+    console.error('Add markers to bring them under the check, or leave them if the list is deliberately hand-written.');
+  };
+
   if (check) {
     if (!stale.length) {
       console.log(`Sidebar link lists are up to date (${results.length} file(s) checked).`);
+      warnUnmarked();
       return 0;
     }
     console.error(`${stale.length} sidebar link list(s) are out of date:\n`);
@@ -369,6 +418,7 @@ function main(argv) {
       console.error('');
     }
     console.error('Run `yarn sidebar-links` to update them.');
+    warnUnmarked();
     return 2;
   }
 
@@ -388,6 +438,7 @@ if (require.main === module) {
 }
 
 module.exports = {
+  unmarkedCandidates,
   buildDocIndex,
   buildSidebarTree,
   processFile,

From 8abf8f1a753b76fb20d1a7aff7a5d5d3de5f8799 Mon Sep 17 00:00:00 2001
From: DABH <DABH@users.noreply.github.com>
Date: Mon, 24 Aug 2026 23:58:05 -0500
Subject: [PATCH 3/5] Generate the SDK landing page section lists from
 sidebars.js
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The eight SDK landing pages restate the sidebar by hand, so adding a page
wires it into sidebars.js and leaves the landing page behind. #5118 is the
current example: it added Serverless Workers pages across seven SDKs, and
six of the seven landing pages never mentioned the feature.

Wraps each `## [Section](url)` list in markers and fills it from the same
sidebar Docusaurus builds the left nav from. This run adds 11 missing
links, including Serverless Workers to all six SDKs that were missing it.

Insert-only on purpose. The sidebar decides which pages appear; existing
lines keep their text and their position, and a line the sidebar doesn't
know about is preserved rather than deleted. Generating labels from the
sidebar would have rewritten 37 of them, several against the sentence-case
rule in readme/STYLE.md, and would have deleted the external links inside
the Integrations sections. The diff here is 125 insertions and no
deletions.

Markers are MDX expression comments, so scripts/mdx-to-md.mjs already
strips them while the bullets survive as ordinary Markdown. That is why
this generates text in place instead of rendering a component: DocCardList
is registered as strip-block, and an unwired GuidesGrid already leaves
build/guides.md at 225 bytes with no links.

Sections whose heading is not a sidebar category — Install and get
started, technical resources, community — carry no markers, so their 58
external links stay hand-written.
---
 bin/generate-sidebar-link-lists.js | 12 ++++++++++--
 docs/develop/dotnet/index.mdx      | 16 ++++++++++++++++
 docs/develop/go/index.mdx          | 16 ++++++++++++++++
 docs/develop/java/index.mdx        | 18 ++++++++++++++++++
 docs/develop/php/index.mdx         | 12 ++++++++++++
 docs/develop/python/index.mdx      | 19 +++++++++++++++++++
 docs/develop/ruby/index.mdx        | 15 +++++++++++++++
 docs/develop/rust/index.mdx        | 11 +++++++++++
 docs/develop/typescript/index.mdx  | 18 ++++++++++++++++++
 9 files changed, 135 insertions(+), 2 deletions(-)

diff --git a/bin/generate-sidebar-link-lists.js b/bin/generate-sidebar-link-lists.js
index 67ba354239..52509c4775 100644
--- a/bin/generate-sidebar-link-lists.js
+++ b/bin/generate-sidebar-link-lists.js
@@ -149,10 +149,18 @@ function findOwningCategory(tree, docId) {
   return found;
 }
 
-function findNamedDescendant(category, label) {
+// Matches a sidebar label or the category's own URL. The URL form exists
+// because a landing page's heading text often isn't the sidebar label —
+// "## [Temporal Client](/develop/python/client)" sits above the category
+// labelled "Client" — and the heading already carries the URL, so an author
+// can copy it rather than having to go read sidebars.js.
+function findNamedDescendant(category, nameOrUrl) {
+  const wanted = String(nameOrUrl).replace(/\/$/, '');
   let found = null;
   eachCategory(category.children, (cat) => {
-    if (!found && cat.label === label) found = cat;
+    if (found) return;
+    if (cat.label === nameOrUrl) found = cat;
+    else if (cat.url && cat.url.replace(/\/$/, '') === wanted) found = cat;
   });
   return found;
 }
diff --git a/docs/develop/dotnet/index.mdx b/docs/develop/dotnet/index.mdx
index 04a93ce7c7..197204c5ec 100644
--- a/docs/develop/dotnet/index.mdx
+++ b/docs/develop/dotnet/index.mdx
@@ -36,6 +36,7 @@ From there, you can dive deeper into any of the Temporal primitives to start bui
 
 ## [Workflows](/develop/dotnet/workflows)
 
+{/* SIDEBAR-LIST-START section="/develop/dotnet/workflows" */}
 - [Workflow basics](/develop/dotnet/workflows/basics)
 - [Child Workflows](/develop/dotnet/workflows/child-workflows)
 - [Continue-As-New](/develop/dotnet/workflows/continue-as-new)
@@ -46,9 +47,11 @@ From there, you can dive deeper into any of the Temporal primitives to start bui
 - [Timers](/develop/dotnet/workflows/timers)
 - [Dynamic Workflow](/develop/dotnet/workflows/dynamic-workflow)
 - [Versioning](/develop/dotnet/workflows/versioning)
+{/* SIDEBAR-LIST-END */}
 
 ## [Activities](/develop/dotnet/activities)
 
+{/* SIDEBAR-LIST-START section="/develop/dotnet/activities" */}
 - [Activity basics](/develop/dotnet/activities/basics)
 - [Activity execution](/develop/dotnet/activities/execution)
 - [Standalone Activities](/develop/dotnet/activities/standalone-activities-quickstart)
@@ -56,32 +59,45 @@ From there, you can dive deeper into any of the Temporal primitives to start bui
 - [Asynchronous Activity completion](/develop/dotnet/activities/asynchronous-activity)
 - [Dynamic Activity](/develop/dotnet/activities/dynamic-activity)
 - [Benign exceptions](/develop/dotnet/activities/benign-exceptions)
+{/* SIDEBAR-LIST-END */}
 
 ## [Workers](/develop/dotnet/workers)
 
+{/* SIDEBAR-LIST-START section="/develop/dotnet/workers" */}
 - [Worker processes](/develop/dotnet/workers/run-worker-process)
 - [Interceptors](/develop/dotnet/workers/interceptors)
+- [Serverless Workers](/develop/dotnet/workers/serverless-workers)
+{/* SIDEBAR-LIST-END */}
 
 ## [Temporal Client](/develop/dotnet/client)
 
+{/* SIDEBAR-LIST-START section="/develop/dotnet/client" */}
 - [Temporal Client](/develop/dotnet/client/temporal-client)
+{/* SIDEBAR-LIST-END */}
 
 ## [Temporal Nexus](/develop/dotnet/nexus)
 
+{/* SIDEBAR-LIST-START section="/develop/dotnet/nexus" */}
 - [Quickstart](/develop/dotnet/nexus/quickstart)
 - [Feature guide](/develop/dotnet/nexus/feature-guide)
+- [Standalone Operations](/develop/dotnet/nexus/standalone-operations)
+{/* SIDEBAR-LIST-END */}
 
 ## [Platform](/develop/dotnet/platform)
 
+{/* SIDEBAR-LIST-START section="/develop/dotnet/platform" */}
 - [Observability](/develop/dotnet/platform/observability)
 - [Enriching the UI](/develop/dotnet/platform/enriching-ui)
+{/* SIDEBAR-LIST-END */}
 
 ## [Best practices](/develop/dotnet/best-practices)
 
+{/* SIDEBAR-LIST-START section="/develop/dotnet/best-practices" */}
 - [Error handling](/develop/dotnet/best-practices/error-handling)
 - [Testing](/develop/dotnet/best-practices/testing-suite)
 - [Debugging](/develop/dotnet/best-practices/debugging)
 - [Converters and encryption](/develop/dotnet/best-practices/data-handling)
+{/* SIDEBAR-LIST-END */}
 
 ## Temporal .NET technical resources
 
diff --git a/docs/develop/go/index.mdx b/docs/develop/go/index.mdx
index d7d076003f..5e5348ca91 100644
--- a/docs/develop/go/index.mdx
+++ b/docs/develop/go/index.mdx
@@ -36,6 +36,7 @@ From there, you can dive deeper into any of the Temporal primitives to start bui
 
 ## [Workflows](/develop/go/workflows)
 
+{/* SIDEBAR-LIST-START section="/develop/go/workflows" */}
 - [Workflow basics](/develop/go/workflows/basics)
 - [Child Workflows](/develop/go/workflows/child-workflows)
 - [Continue-As-New](/develop/go/workflows/continue-as-new)
@@ -49,9 +50,11 @@ From there, you can dive deeper into any of the Temporal primitives to start bui
 - [Dynamic Workflow](/develop/go/workflows/dynamic-workflow)
 - [Versioning](/develop/go/workflows/versioning)
 - [Workflow Streams](/develop/go/workflows/workflow-streams)
+{/* SIDEBAR-LIST-END */}
 
 ## [Activities](/develop/go/activities)
 
+{/* SIDEBAR-LIST-START section="/develop/go/activities" */}
 - [Activity basics](/develop/go/activities/basics)
 - [Activity execution](/develop/go/activities/execution)
 - [Standalone Activities](/develop/go/activities/standalone-activities-quickstart)
@@ -59,42 +62,55 @@ From there, you can dive deeper into any of the Temporal primitives to start bui
 - [Asynchronous Activity completion](/develop/go/activities/asynchronous-activity)
 - [Dynamic Activity](/develop/go/activities/dynamic-activity)
 - [Benign exceptions](/develop/go/activities/benign-exceptions)
+{/* SIDEBAR-LIST-END */}
 
 ## [Workers](/develop/go/workers)
 
+{/* SIDEBAR-LIST-START section="/develop/go/workers" */}
 - [Run a Worker](/develop/go/workers/run-worker-process)
 - [Sessions](/develop/go/workers/sessions)
 - [Serverless Workers](/develop/go/workers/serverless-workers)
+{/* SIDEBAR-LIST-END */}
 
 ## [Temporal Client](/develop/go/client)
 
+{/* SIDEBAR-LIST-START section="/develop/go/client" */}
 - [Temporal Client](/develop/go/client/temporal-client)
 - [Namespaces](/develop/go/client/namespaces)
+{/* SIDEBAR-LIST-END */}
 
 ## [Temporal Nexus](/develop/go/nexus)
 
+{/* SIDEBAR-LIST-START section="/develop/go/nexus" */}
 - [Quickstart](/develop/go/nexus/quickstart)
 - [Feature guide](/develop/go/nexus/feature-guide)
 - [Standalone Operations](/develop/go/nexus/standalone-operations)
+{/* SIDEBAR-LIST-END */}
 
 ## [Platform](/develop/go/platform)
 
+{/* SIDEBAR-LIST-START section="/develop/go/platform" */}
 - [Observability](/develop/go/platform/observability)
 - [Enriching the UI](/develop/go/platform/enriching-ui)
+{/* SIDEBAR-LIST-END */}
 
 ## [Best practices](/develop/go/best-practices)
 
+{/* SIDEBAR-LIST-START section="/develop/go/best-practices" */}
 - [Multithreading](/develop/go/best-practices/multithreading)
 - [Context propagation](/develop/go/best-practices/context-propagation)
 - [Error handling](/develop/go/best-practices/error-handling)
 - [Debugging](/develop/go/best-practices/debugging)
 - [Testing](/develop/go/best-practices/testing-suite)
 - [Data handling](/develop/go/data-handling)
+{/* SIDEBAR-LIST-END */}
 
 ## [Integrations](/develop/go/integrations)
 
+{/* SIDEBAR-LIST-START section="/develop/go/integrations" */}
 - [Google ADK integration](/develop/go/integrations/google-adk)
 - [OpenTelemetry v2 integration](/develop/go/integrations/opentelemetry-v2)
+{/* SIDEBAR-LIST-END */}
 
 ## Temporal Go technical resources
 
diff --git a/docs/develop/java/index.mdx b/docs/develop/java/index.mdx
index c4ad311a11..035665029d 100644
--- a/docs/develop/java/index.mdx
+++ b/docs/develop/java/index.mdx
@@ -34,6 +34,7 @@ From there, you can dive deeper into any of the Temporal primitives to start bui
 
 ## [Workflows](/develop/java/workflows)
 
+{/* SIDEBAR-LIST-START section="/develop/java/workflows" */}
 - [Workflow basics](/develop/java/workflows/basics)
 - [Child Workflows](/develop/java/workflows/child-workflows)
 - [Continue-As-New](/develop/java/workflows/continue-as-new)
@@ -45,48 +46,65 @@ From there, you can dive deeper into any of the Temporal primitives to start bui
 - [Side effects](/develop/java/workflows/side-effects)
 - [Versioning](/develop/java/workflows/versioning)
 - [Workflow Streams](/develop/java/workflows/workflow-streams)
+{/* SIDEBAR-LIST-END */}
 
 ## [Activities](/develop/java/activities)
 
+{/* SIDEBAR-LIST-START section="/develop/java/activities" */}
 - [Activity basics](/develop/java/activities/basics)
 - [Activity execution](/develop/java/activities/execution)
 - [Standalone Activities](/develop/java/activities/standalone-activities-quickstart)
 - [Timeouts](/develop/java/activities/timeouts)
 - [Asynchronous Activity Completion](/develop/java/activities/asynchronous-activity)
 - [Benign exceptions](/develop/java/activities/benign-exceptions)
+{/* SIDEBAR-LIST-END */}
 
 ## [Workers](/develop/java/workers)
 
+{/* SIDEBAR-LIST-START section="/develop/java/workers" */}
 - [Worker processes](/develop/java/workers/run-worker-process)
+- [Serverless Workers](/develop/java/workers/serverless-workers)
 - [Observability](/develop/java/platform/observability)
+{/* SIDEBAR-LIST-END */}
 
 ## [Temporal Client](/develop/java/client)
 
+{/* SIDEBAR-LIST-START section="/develop/java/client" */}
 - [Temporal Client](/develop/java/client/temporal-client)
 - [Namespaces](/develop/java/client/namespaces)
+{/* SIDEBAR-LIST-END */}
 
 ## [Temporal Nexus](/develop/java/nexus)
 
+{/* SIDEBAR-LIST-START section="/develop/java/nexus" */}
 - [Quickstart](/develop/java/nexus/quickstart)
 - [Feature guide](/develop/java/nexus/feature-guide)
 - [Standalone Operations](/develop/java/nexus/standalone-operations)
+{/* SIDEBAR-LIST-END */}
 
 ## [Platform](/develop/java/platform)
 
+{/* SIDEBAR-LIST-START section="/develop/java/platform" */}
 - [Observability](/develop/java/platform/observability)
 - [Enriching the UI](/develop/java/platform/enriching-ui)
+{/* SIDEBAR-LIST-END */}
 
 ## [Best practices](/develop/java/best-practices)
 
+{/* SIDEBAR-LIST-START section="/develop/java/best-practices" */}
+- [Error handling](/develop/java/best-practices/error-handling)
 - [Testing](/develop/java/best-practices/testing-suite)
 - [Debugging](/develop/java/best-practices/debugging)
 - [Converters and encryption](/develop/java/best-practices/data-handling)
+{/* SIDEBAR-LIST-END */}
 
 ## [Integrations](/develop/java/integrations)
 
+{/* SIDEBAR-LIST-START section="/develop/java/integrations" */}
 - [Parseable integration](https://github.com/parseablehq/temporal-plugin-java/blob/main/INTEGRATION.md)
 - [Spring AI integration](/develop/java/integrations/spring-ai)
 - [Spring Boot integration](/develop/java/integrations/spring-boot-integration)
+{/* SIDEBAR-LIST-END */}
 
 ## Temporal Java technical resources
 
diff --git a/docs/develop/php/index.mdx b/docs/develop/php/index.mdx
index 90d4e1794d..27cfa0c41a 100644
--- a/docs/develop/php/index.mdx
+++ b/docs/develop/php/index.mdx
@@ -34,6 +34,7 @@ From there, you can dive deeper into any of the Temporal primitives to start bui
 
 ## [Workflows](/develop/php/workflows)
 
+{/* SIDEBAR-LIST-START section="/develop/php/workflows" */}
 - [Workflow Basics](/develop/php/workflows/basics)
 - [Child Workflows](/develop/php/workflows/child-workflows)
 - [Continue-As-New](/develop/php/workflows/continue-as-new)
@@ -44,31 +45,42 @@ From there, you can dive deeper into any of the Temporal primitives to start bui
 - [Timers](/develop/php/workflows/timers)
 - [Side effects](/develop/php/workflows/side-effects)
 - [Versioning](/develop/php/workflows/versioning)
+{/* SIDEBAR-LIST-END */}
 
 ## [Activities](/develop/php/activities)
 
+{/* SIDEBAR-LIST-START section="/develop/php/activities" */}
 - [Activity Basics](/develop/php/activities/basics)
 - [Activity Execution](/develop/php/activities/execution)
 - [Timeouts](/develop/php/activities/timeouts)
 - [Asynchronous Activity Completion](/develop/php/activities/asynchronous-activity)
+{/* SIDEBAR-LIST-END */}
 
 ## [Workers](/develop/php/workers)
 
+{/* SIDEBAR-LIST-START section="/develop/php/workers" */}
 - [Run Worker processes](/develop/php/workers/run-worker-process)
+{/* SIDEBAR-LIST-END */}
 
 ## [Temporal Client](/develop/php/client)
 
+{/* SIDEBAR-LIST-START section="/develop/php/client" */}
 - [Temporal Client](/develop/php/client/temporal-client)
+{/* SIDEBAR-LIST-END */}
 
 ## [Platform](/develop/php/platform)
 
+{/* SIDEBAR-LIST-START section="/develop/php/platform" */}
 - [Observability](/develop/php/platform/observability)
 - [Enriching the UI](/develop/php/platform/enriching-ui)
+{/* SIDEBAR-LIST-END */}
 
 ## [Best practices](/develop/php/best-practices)
 
+{/* SIDEBAR-LIST-START section="/develop/php/best-practices" */}
 - [Testing](/develop/php/best-practices/testing-suite)
 - [Debugging](/develop/php/best-practices/debugging)
+{/* SIDEBAR-LIST-END */}
 
 ## Temporal PHP technical resources
 
diff --git a/docs/develop/python/index.mdx b/docs/develop/python/index.mdx
index 0095fd8719..bbbe37959b 100644
--- a/docs/develop/python/index.mdx
+++ b/docs/develop/python/index.mdx
@@ -34,6 +34,7 @@ From there, you can dive deeper into any of the Temporal primitives to start bui
 
 ## [Workflows](/develop/python/workflows)
 
+{/* SIDEBAR-LIST-START section="/develop/python/workflows" */}
 - [Workflow basics](/develop/python/workflows/basics)
 - [Child Workflows](/develop/python/workflows/child-workflows)
 - [Continue-As-New](/develop/python/workflows/continue-as-new)
@@ -44,45 +45,62 @@ From there, you can dive deeper into any of the Temporal primitives to start bui
 - [Timers](/develop/python/workflows/timers)
 - [Versioning](/develop/python/workflows/versioning)
 - [Workflow Streams](/develop/python/workflows/workflow-streams)
+{/* SIDEBAR-LIST-END */}
 
 ## [Activities](/develop/python/activities)
 
+{/* SIDEBAR-LIST-START section="/develop/python/activities" */}
 - [Activity basics](/develop/python/activities/basics)
 - [Activity execution](/develop/python/activities/execution)
 - [Standalone Activities](/develop/python/activities/standalone-activities-quickstart)
 - [Timeouts](/develop/python/activities/timeouts)
 - [Asynchronous Activity completion](/develop/python/activities/asynchronous-activity)
 - [Benign exceptions](/develop/python/activities/benign-exceptions)
+{/* SIDEBAR-LIST-END */}
 
 ## [Workers](/develop/python/workers)
 
+{/* SIDEBAR-LIST-START section="/develop/python/workers" */}
 - [Worker processes](/develop/python/workers/run-worker-process)
+- [Interceptors](/develop/python/workers/interceptors)
+- [Serverless Workers](/develop/python/workers/serverless-workers)
+{/* SIDEBAR-LIST-END */}
 
 ## [Temporal Client](/develop/python/client)
 
+{/* SIDEBAR-LIST-START section="/develop/python/client" */}
 - [Temporal Client](/develop/python/client/temporal-client)
+{/* SIDEBAR-LIST-END */}
 
 ## [Temporal Nexus](/develop/python/nexus)
 
+{/* SIDEBAR-LIST-START section="/develop/python/nexus" */}
 - [Quickstart](/develop/python/nexus/quickstart)
 - [Feature guide](/develop/python/nexus/feature-guide)
 - [Standalone Operations](/develop/python/nexus/standalone-operations)
+{/* SIDEBAR-LIST-END */}
 
 ## [Platform](/develop/python/platform)
 
+{/* SIDEBAR-LIST-START section="/develop/python/platform" */}
 - [Observability](/develop/python/platform/observability)
 - [Enriching the UI](/develop/python/platform/enriching-ui)
+{/* SIDEBAR-LIST-END */}
 
 ## [Best practices](/develop/python/best-practices)
 
+{/* SIDEBAR-LIST-START section="/develop/python/best-practices" */}
+- [Error handling](/develop/python/best-practices/error-handling)
 - [Testing](/develop/python/best-practices/testing-suite)
 - [Python SDK sandbox](/develop/python/best-practices/python-sdk-sandbox)
 - [Debugging](/develop/python/best-practices/debugging)
 - [Data handling](/develop/python/data-handling)
 - [Sync vs async](/develop/python/best-practices/python-sdk-sync-vs-async)
+{/* SIDEBAR-LIST-END */}
 
 ## [Integrations](/develop/python/integrations)
 
+{/* SIDEBAR-LIST-START section="/develop/python/integrations" */}
 - [Braintrust integration](/develop/python/integrations/braintrust)
 - [Deep Agents integration](/develop/python/integrations/deepagents)
 - [Google ADK integration](/develop/python/integrations/google-adk)
@@ -96,6 +114,7 @@ From there, you can dive deeper into any of the Temporal primitives to start bui
 - [Pydantic AI integration](https://ai.pydantic.dev/durable_execution/temporal/)
 - [Strands Agents integration](/develop/python/integrations/strands-agents)
 - [Tenuo integration](https://tenuo.ai/temporal)
+{/* SIDEBAR-LIST-END */}
 
 ## Temporal Python technical resources
 
diff --git a/docs/develop/ruby/index.mdx b/docs/develop/ruby/index.mdx
index ad50a4e762..3158e313ba 100644
--- a/docs/develop/ruby/index.mdx
+++ b/docs/develop/ruby/index.mdx
@@ -38,6 +38,7 @@ From there, you can dive deeper into any of the Temporal primitives to start bui
 
 ## [Workflows](/develop/ruby/workflows)
 
+{/* SIDEBAR-LIST-START section="/develop/ruby/workflows" */}
 - [Workflow basics](/develop/ruby/workflows/basics)
 - [Child Workflows](/develop/ruby/workflows/child-workflows)
 - [Continue-As-New](/develop/ruby/workflows/continue-as-new)
@@ -49,9 +50,11 @@ From there, you can dive deeper into any of the Temporal primitives to start bui
 - [Futures](/develop/ruby/workflows/futures)
 - [Dynamic Workflow](/develop/ruby/workflows/dynamic-workflow)
 - [Versioning](/develop/ruby/workflows/versioning)
+{/* SIDEBAR-LIST-END */}
 
 ## [Activities](/develop/ruby/activities)
 
+{/* SIDEBAR-LIST-START section="/develop/ruby/activities" */}
 - [Activity basics](/develop/ruby/activities/basics)
 - [Activity execution](/develop/ruby/activities/execution)
 - [Standalone Activities](/develop/ruby/activities/standalone-activities-quickstart)
@@ -59,31 +62,43 @@ From there, you can dive deeper into any of the Temporal primitives to start bui
 - [Asynchronous Activity completion](/develop/ruby/activities/asynchronous-activity)
 - [Dynamic Activity](/develop/ruby/activities/dynamic-activity)
 - [Benign exceptions](/develop/ruby/activities/benign-exceptions)
+{/* SIDEBAR-LIST-END */}
 
 ## [Workers](/develop/ruby/workers)
 
+{/* SIDEBAR-LIST-START section="/develop/ruby/workers" */}
 - [Worker processes](/develop/ruby/workers/run-worker-process)
+- [Serverless Workers](/develop/ruby/workers/serverless-workers)
 - [Observability](/develop/ruby/platform/observability)
+{/* SIDEBAR-LIST-END */}
 
 ## [Temporal Client](/develop/ruby/client)
 
+{/* SIDEBAR-LIST-START section="/develop/ruby/client" */}
 - [Temporal Client](/develop/ruby/client/temporal-client)
+{/* SIDEBAR-LIST-END */}
 
 ## [Platform](/develop/ruby/platform)
 
+{/* SIDEBAR-LIST-START section="/develop/ruby/platform" */}
 - [Observability](/develop/ruby/platform/observability)
 - [Enriching the UI](/develop/ruby/platform/enriching-ui)
+{/* SIDEBAR-LIST-END */}
 
 ## [Integrations](/develop/ruby/integrations)
 
+{/* SIDEBAR-LIST-START section="/develop/ruby/integrations" */}
 - [Rails integration](/develop/ruby/integrations/rails-integration)
+{/* SIDEBAR-LIST-END */}
 
 ## [Best practices](/develop/ruby/best-practices)
 
+{/* SIDEBAR-LIST-START section="/develop/ruby/best-practices" */}
 - [Error handling](/develop/ruby/best-practices/error-handling)
 - [Testing](/develop/ruby/best-practices/testing-suite)
 - [Debugging](/develop/ruby/best-practices/debugging)
 - [Converters and encryption](/develop/ruby/best-practices/data-handling)
+{/* SIDEBAR-LIST-END */}
 
 ## Temporal Ruby technical resources
 
diff --git a/docs/develop/rust/index.mdx b/docs/develop/rust/index.mdx
index 61c03ba94b..31c42a5707 100644
--- a/docs/develop/rust/index.mdx
+++ b/docs/develop/rust/index.mdx
@@ -31,6 +31,7 @@ Once your local Temporal Service is set up, continue building with the following
 
 ## [Workflows](/develop/rust/workflows)
 
+{/* SIDEBAR-LIST-START section="/develop/rust/workflows" */}
 - [Workflow basics](/develop/rust/workflows/basics)
 - [Child Workflows](/develop/rust/workflows/child-workflows)
 - [Continue-As-New](/develop/rust/workflows/continue-as-new)
@@ -38,24 +39,34 @@ Once your local Temporal Service is set up, continue building with the following
 - [Cancellation](/develop/rust/workflows/cancellation)
 - [Timers](/develop/rust/workflows/timers)
 - [Timeouts](/develop/rust/workflows/timeouts)
+{/* SIDEBAR-LIST-END */}
 
 ## [Activities](/develop/rust/activities)
 
+{/* SIDEBAR-LIST-START section="/develop/rust/activities" */}
 - [Activity basics](/develop/rust/activities/basics)
 - [Activity execution](/develop/rust/activities/execution)
 - [Timeouts](/develop/rust/activities/timeouts)
+{/* SIDEBAR-LIST-END */}
 
 ## [Workers](/develop/rust/workers)
 
+{/* SIDEBAR-LIST-START section="/develop/rust/workers" */}
 - [Worker processes](/develop/rust/workers/worker-process)
+- [Serverless Workers](/develop/rust/workers/serverless-workers)
+{/* SIDEBAR-LIST-END */}
 
 ## [Temporal Client](/develop/rust/client)
 
+{/* SIDEBAR-LIST-START section="/develop/rust/client" */}
 - [Temporal Client](/develop/rust/client/temporal-client)
+{/* SIDEBAR-LIST-END */}
 
 ## [Temporal Nexus](/develop/rust/nexus)
 
+{/* SIDEBAR-LIST-START section="/develop/rust/nexus" */}
 - [Feature guide](/develop/rust/nexus/feature-guide)
+{/* SIDEBAR-LIST-END */}
 
 ## Temporal Rust technical resources
 
diff --git a/docs/develop/typescript/index.mdx b/docs/develop/typescript/index.mdx
index 4cf2e9edcc..efe968d1ca 100644
--- a/docs/develop/typescript/index.mdx
+++ b/docs/develop/typescript/index.mdx
@@ -34,6 +34,7 @@ Once your local Temporal Service is set up, continue building with the following
 
 ## [Workflows](/develop/typescript/workflows)
 
+{/* SIDEBAR-LIST-START section="/develop/typescript/workflows" */}
 - [Workflow basics](/develop/typescript/workflows/basics)
 - [Child Workflows](/develop/typescript/workflows/child-workflows)
 - [Continue-As-New](/develop/typescript/workflows/continue-as-new)
@@ -45,45 +46,61 @@ Once your local Temporal Service is set up, continue building with the following
 - [Timers](/develop/typescript/workflows/timers)
 - [Versioning](/develop/typescript/workflows/versioning)
 - [Workflow Streams](/develop/typescript/workflows/workflow-streams)
+{/* SIDEBAR-LIST-END */}
 
 ## [Activities](/develop/typescript/activities)
 
+{/* SIDEBAR-LIST-START section="/develop/typescript/activities" */}
 - [Activity basics](/develop/typescript/activities/basics)
 - [Activity execution](/develop/typescript/activities/execution)
+- [Standalone Activities](/develop/typescript/activities/standalone-activities-quickstart)
 - [Timeouts](/develop/typescript/activities/timeouts)
 - [Asynchronous Activity](/develop/typescript/activities/asynchronous-activity)
 - [Benign exceptions](/develop/typescript/activities/benign-exceptions)
+{/* SIDEBAR-LIST-END */}
 
 ## [Workers](/develop/typescript/workers)
 
+{/* SIDEBAR-LIST-START section="/develop/typescript/workers" */}
 - [Worker processes](/develop/typescript/workers/run-worker-process)
 - [Interceptors](/develop/typescript/workers/interceptors)
+- [Serverless Workers](/develop/typescript/workers/serverless-workers)
+{/* SIDEBAR-LIST-END */}
 
 ## [Temporal Client](/develop/typescript/client)
 
+{/* SIDEBAR-LIST-START section="/develop/typescript/client" */}
 - [Temporal Client](/develop/typescript/client/temporal-client)
 - [Namespaces](/develop/typescript/client/namespaces)
+{/* SIDEBAR-LIST-END */}
 
 ## [Temporal Nexus](/develop/typescript/nexus)
 
+{/* SIDEBAR-LIST-START section="/develop/typescript/nexus" */}
 - [Quickstart](/develop/typescript/nexus/quickstart)
 - [Feature guide](/develop/typescript/nexus/feature-guide)
 - [Standalone Operations](/develop/typescript/nexus/standalone-operations)
+{/* SIDEBAR-LIST-END */}
 
 ## [Platform](/develop/typescript/platform)
 
+{/* SIDEBAR-LIST-START section="/develop/typescript/platform" */}
 - [Observability](/develop/typescript/platform/observability)
 - [Enriching the UI](/develop/typescript/platform/enriching-ui)
+{/* SIDEBAR-LIST-END */}
 
 ## [Best practices](/develop/typescript/best-practices)
 
+{/* SIDEBAR-LIST-START section="/develop/typescript/best-practices" */}
 - [Testing](/develop/typescript/best-practices/testing-suite)
 - [Debugging](/develop/typescript/best-practices/debugging)
 - [Converters and encryption](/develop/typescript/best-practices/data-handling)
 - [Entity pattern](/develop/typescript/best-practices/entity-pattern)
+{/* SIDEBAR-LIST-END */}
 
 ## [Integrations](/develop/typescript/integrations)
 
+{/* SIDEBAR-LIST-START section="/develop/typescript/integrations" */}
 - [Braintrust integration](https://www.braintrust.dev/docs/integrations/sdk-integrations/temporal#typescript)
 - [LangSmith integration](/develop/typescript/integrations/langsmith)
 - [Mastra integration](https://mastra.ai/guides/deployment/temporal)
@@ -91,6 +108,7 @@ Once your local Temporal Service is set up, continue building with the following
 - [Parseable integration](https://github.com/parseablehq/temporal-plugin/blob/main/INTEGRATION.md)
 - [Strands Agents integration](/develop/typescript/integrations/strands-agents)
 - [Vercel AI SDK integration](/develop/typescript/integrations/ai-sdk)
+{/* SIDEBAR-LIST-END */}
 
 ## Temporal TypeScript technical resources
 

From abb4d4ce24a8cc8c7c763be21bdb358e813605cd Mon Sep 17 00:00:00 2001
From: DABH <DABH@users.noreply.github.com>
Date: Tue, 25 Aug 2026 00:06:44 -0500
Subject: [PATCH 4/5] Fix five defects found reviewing the generator
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- The preserved count used existing.length - sidebarUrls.size, which went
  negative whenever the sidebar had more entries than the page listed.
- Blank lines inside a marked region were dropped, so "insert-only" was
  quietly destructive on a region with deliberate spacing.
- A label-form section= silently resolved to whichever same-named category
  came first in traversal order. "Quickstart" appears under several
  sections, so this now refuses and points at the URL form.
- Coverage reporting skipped pages with fewer than two links, which hid 10
  pages including four workers/index.mdx — the pages most likely to be
  missing an entry, since a one-link list is thinner than a ten-link one.
- The not-found error said "no category labelled" even when the marker had
  supplied a URL.

Also adds five processFile tests. That function had none, so marker
parsing, the unmatched-END and unresolvable-page errors, and the promise
that content outside the markers never changes were all unverified.
---
 bin/generate-sidebar-link-lists.js      | 46 +++++++++-----
 bin/generate-sidebar-link-lists.test.js | 81 +++++++++++++++++++++++++
 2 files changed, 112 insertions(+), 15 deletions(-)

diff --git a/bin/generate-sidebar-link-lists.js b/bin/generate-sidebar-link-lists.js
index 52509c4775..64175a2a7f 100644
--- a/bin/generate-sidebar-link-lists.js
+++ b/bin/generate-sidebar-link-lists.js
@@ -156,13 +156,24 @@ function findOwningCategory(tree, docId) {
 // can copy it rather than having to go read sidebars.js.
 function findNamedDescendant(category, nameOrUrl) {
   const wanted = String(nameOrUrl).replace(/\/$/, '');
-  let found = null;
+  const byUrl = [];
+  const byLabel = [];
   eachCategory(category.children, (cat) => {
-    if (found) return;
-    if (cat.label === nameOrUrl) found = cat;
-    else if (cat.url && cat.url.replace(/\/$/, '') === wanted) found = cat;
+    if (cat.url && cat.url.replace(/\/$/, '') === wanted) byUrl.push(cat);
+    else if (cat.label === nameOrUrl) byLabel.push(cat);
   });
-  return found;
+
+  // A URL is unique, so prefer it and don't let a same-named category elsewhere
+  // in the tree interfere.
+  if (byUrl.length) return byUrl[0];
+
+  // Labels are not unique — "Quickstart" appears under several sections — so
+  // refuse rather than silently picking whichever came first in traversal.
+  if (byLabel.length > 1) {
+    const urls = byLabel.map((c) => c.url || '(no link)').join(', ');
+    throw new Error(`"${nameOrUrl}" matches ${byLabel.length} categories under "${category.label}" (${urls}); use the category URL instead of its label`);
+  }
+  return byLabel[0] || null;
 }
 
 // ---------------------------------------------------------------------------
@@ -213,12 +224,13 @@ const BULLET = /^\s*-\s*\[(?<label>[^\]]+)\]\((?<url>[^)]+)\)\s*$/;
 // isn't in this category at all (an external tutorial link, say) is preserved
 // rather than deleted.
 function reconcileList(category, existingLines, indent) {
-  const existing = [];
-  for (const line of existingLines) {
+  // Every line is kept, blank ones included. Dropping blanks would make this
+  // silently destructive on a region that had deliberate spacing, which is
+  // exactly what "insert-only" promises not to do.
+  const existing = existingLines.map((line) => {
     const m = line.match(BULLET);
-    if (m) existing.push({ line, url: m.groups.url, label: m.groups.label });
-    else if (line.trim() !== '') existing.push({ line, url: null, label: null });
-  }
+    return m ? { line, url: m.groups.url, label: m.groups.label } : { line, url: null, label: null };
+  });
 
   const generated = renderList(category, indent).map((line) => {
     const m = line.match(BULLET);
@@ -257,7 +269,8 @@ function reconcileList(category, existingLines, indent) {
     added.push(g.url);
   });
 
-  return { lines: out, added, preserved: existing.length - sidebarUrls.size };
+  const preserved = existing.filter((e) => e.url && !sidebarUrls.has(e.url)).length;
+  return { lines: out, added, preserved };
 }
 
 function parseAttrs(raw) {
@@ -296,10 +309,10 @@ function processFile(filePath, tree, docs) {
     }
     const target = section ? findNamedDescendant(owning, section) : owning;
     if (!target) {
-      throw new Error(`${path.relative(process.cwd(), filePath)}: no category labelled "${section}" under "${owning.label}"`);
+      throw new Error(`${path.relative(process.cwd(), filePath)}: no category matching "${section}" (by label or URL) under "${owning.label}"`);
     }
 
-    const actual = lines.slice(i + 1, close).filter((l) => l.trim() !== '');
+    const actual = lines.slice(i + 1, close);
     const { lines: expected, added, preserved } = reconcileList(target, actual, indent);
     regions.push({
       section: section || owning.label,
@@ -349,9 +362,12 @@ function unmarkedCandidates(tree) {
     const text = fs.readFileSync(filePath, 'utf8');
     if (/SIDEBAR-LIST-START/.test(text)) continue;
 
-    // Only pages that already hand-maintain a list of internal links.
+    // Any page that already hand-maintains internal links qualifies. A single
+    // link counts: a Workers page listing one entry is likelier to be missing
+    // something than one listing ten, and an earlier `< 2` cutoff hid exactly
+    // those pages — four workers/index.mdx among them.
     const bullets = [...text.matchAll(/^-\s*\[[^\]]+\]\((\/[^)]+)\)\s*$/gm)];
-    if (bullets.length < 2) continue;
+    if (bullets.length < 1) continue;
 
     const category = findOwningCategory(tree, computeDocId(filePath));
     if (!category) continue;
diff --git a/bin/generate-sidebar-link-lists.test.js b/bin/generate-sidebar-link-lists.test.js
index 092851ec50..efe23eaaf3 100644
--- a/bin/generate-sidebar-link-lists.test.js
+++ b/bin/generate-sidebar-link-lists.test.js
@@ -1,5 +1,7 @@
 const test = require('node:test');
 const assert = require('node:assert');
+const fs = require('node:fs');
+const path = require('node:path');
 
 const {
   reconcileList,
@@ -7,6 +9,8 @@ const {
   buildDocIndex,
   buildSidebarTree,
   findOwningCategory,
+  findNamedDescendant,
+  processFile,
 } = require('./generate-sidebar-link-lists');
 
 // Synthetic categories keep these cases stable as the real docs change.
@@ -116,3 +120,80 @@ test('every SDK section index page resolves to a sidebar category', () => {
 
   assert.deepStrictEqual(missing, [], 'these pages have no owning sidebar category');
 });
+
+// ---------------------------------------------------------------------------
+// processFile: marker parsing and the error paths. These run against a real
+// temporary page under docs/ because the doc id -> sidebar category lookup
+// only means anything against the real sidebars.js.
+// ---------------------------------------------------------------------------
+
+const TMP_DIR = path.join(process.cwd(), 'docs', 'develop', '_sidebar_link_list_fixture');
+
+function withFixture(body, run) {
+  fs.mkdirSync(TMP_DIR, { recursive: true });
+  const file = path.join(TMP_DIR, 'index.mdx');
+  fs.writeFileSync(file, body);
+  try {
+    return run(file);
+  } finally {
+    fs.rmSync(TMP_DIR, { recursive: true, force: true });
+  }
+}
+
+test('processFile rejects a region with no closing marker', () => {
+  const docs = buildDocIndex();
+  const tree = buildSidebarTree(docs);
+  withFixture('---\nid: index\n---\n\n{/* SIDEBAR-LIST-START */}\n- [A](/a)\n', (file) => {
+    assert.throws(() => processFile(file, tree, docs), /no matching SIDEBAR-LIST-END/);
+  });
+});
+
+test('processFile rejects a page no sidebar category links to', () => {
+  const docs = buildDocIndex();
+  const tree = buildSidebarTree(docs);
+  withFixture('---\nid: index\n---\n\n{/* SIDEBAR-LIST-START */}\n{/* SIDEBAR-LIST-END */}\n', (file) => {
+    assert.throws(() => processFile(file, tree, docs), /no sidebars\.js category links to this page/);
+  });
+});
+
+test('processFile leaves everything outside the markers untouched', () => {
+  const docs = buildDocIndex();
+  const tree = buildSidebarTree(docs);
+  const real = path.join(process.cwd(), 'docs', 'develop', 'python', 'index.mdx');
+  const before = fs.readFileSync(real, 'utf8');
+  const { content, regions } = processFile(real, tree, docs);
+
+  assert.ok(regions.length > 0, 'the Python landing page should have marked regions');
+
+  // Compare everything that is not inside a marked region.
+  const strip = (text) => {
+    const out = [];
+    let inside = false;
+    for (const line of text.split('\n')) {
+      if (/SIDEBAR-LIST-START/.test(line)) { inside = true; out.push(line); continue; }
+      if (/SIDEBAR-LIST-END/.test(line)) { inside = false; out.push(line); continue; }
+      if (!inside) out.push(line);
+    }
+    return out.join('\n');
+  };
+  assert.strictEqual(strip(content), strip(before), 'content outside the markers must not change');
+});
+
+test('processFile is a no-op on an already-current page', () => {
+  const docs = buildDocIndex();
+  const tree = buildSidebarTree(docs);
+  const real = path.join(process.cwd(), 'docs', 'develop', 'python', 'index.mdx');
+  const { changed } = processFile(real, tree, docs);
+  assert.strictEqual(changed, false, 'run `yarn sidebar-links` — the committed page is stale');
+});
+
+test('a marker keyed by category URL resolves even when the heading text differs', () => {
+  // "## [Temporal Client](/develop/python/client)" sits above the category
+  // labelled "Client", which is why the URL form exists.
+  const docs = buildDocIndex();
+  const tree = buildSidebarTree(docs);
+  const own = findOwningCategory(tree, 'develop/python/index');
+  assert.ok(own, 'the Python SDK category should link develop/python/index');
+  assert.strictEqual(findNamedDescendant(own, '/develop/python/client').label, 'Client');
+  assert.strictEqual(findNamedDescendant(own, 'Temporal Client'), null, 'heading text is not a sidebar label');
+});

From 57f11f4b95495902520b8c87561601685f9afbb7 Mon Sep 17 00:00:00 2001
From: DABH <DABH@users.noreply.github.com>
Date: Tue, 25 Aug 2026 01:18:12 -0500
Subject: [PATCH 5/5] Close the Serverless Workers gap on the Workers index
 pages too

This PR marked docs/develop/python/workers/index.mdx but left the same gap
on the other five, so it claimed section index pages were out of scope
while including one of them. All six now carry the link, which makes the
scope coherent: the Serverless Workers gap is closed at both the landing
page and the section index level. The other 46 section index pages remain
the separate sweep.
---
 docs/develop/dotnet/workers/index.mdx     | 3 +++
 docs/develop/java/workers/index.mdx       | 3 +++
 docs/develop/ruby/workers/index.mdx       | 3 +++
 docs/develop/rust/workers/index.mdx       | 3 +++
 docs/develop/typescript/workers/index.mdx | 3 +++
 5 files changed, 15 insertions(+)

diff --git a/docs/develop/dotnet/workers/index.mdx b/docs/develop/dotnet/workers/index.mdx
index e16176e1e1..495e55ce43 100644
--- a/docs/develop/dotnet/workers/index.mdx
+++ b/docs/develop/dotnet/workers/index.mdx
@@ -19,5 +19,8 @@ import * as Components from '@site/src/components';
 
 ## Workers
 
+{/* SIDEBAR-LIST-START */}
 - [Worker processes](/develop/dotnet/workers/run-worker-process)
 - [Interceptors](/develop/dotnet/workers/interceptors)
+- [Serverless Workers](/develop/dotnet/workers/serverless-workers)
+{/* SIDEBAR-LIST-END */}
diff --git a/docs/develop/java/workers/index.mdx b/docs/develop/java/workers/index.mdx
index 24f6e9f90d..a43ca8f9c9 100644
--- a/docs/develop/java/workers/index.mdx
+++ b/docs/develop/java/workers/index.mdx
@@ -19,4 +19,7 @@ import * as Components from '@site/src/components';
 
 ## Workers
 
+{/* SIDEBAR-LIST-START */}
 - [Run Worker processes](/develop/java/workers/run-worker-process)
+- [Serverless Workers](/develop/java/workers/serverless-workers)
+{/* SIDEBAR-LIST-END */}
diff --git a/docs/develop/ruby/workers/index.mdx b/docs/develop/ruby/workers/index.mdx
index b345b79db4..767cb9966a 100644
--- a/docs/develop/ruby/workers/index.mdx
+++ b/docs/develop/ruby/workers/index.mdx
@@ -19,4 +19,7 @@ import * as Components from '@site/src/components';
 
 ## Workers
 
+{/* SIDEBAR-LIST-START */}
 - [Worker processes](/develop/ruby/workers/run-worker-process)
+- [Serverless Workers](/develop/ruby/workers/serverless-workers)
+{/* SIDEBAR-LIST-END */}
diff --git a/docs/develop/rust/workers/index.mdx b/docs/develop/rust/workers/index.mdx
index e9a9880c20..4a4876251b 100644
--- a/docs/develop/rust/workers/index.mdx
+++ b/docs/develop/rust/workers/index.mdx
@@ -20,4 +20,7 @@ import * as Components from '@site/src/components';
 
 ## Workers
 
+{/* SIDEBAR-LIST-START */}
 - [Worker processes](/develop/rust/workers/worker-process)
+- [Serverless Workers](/develop/rust/workers/serverless-workers)
+{/* SIDEBAR-LIST-END */}
diff --git a/docs/develop/typescript/workers/index.mdx b/docs/develop/typescript/workers/index.mdx
index 6eec105f56..24ea437337 100644
--- a/docs/develop/typescript/workers/index.mdx
+++ b/docs/develop/typescript/workers/index.mdx
@@ -20,5 +20,8 @@ import * as Components from '@site/src/components';
 
 ## Workers
 
+{/* SIDEBAR-LIST-START */}
 - [Worker processes](/develop/typescript/workers/run-worker-process)
 - [Interceptors](/develop/typescript/workers/interceptors)
+- [Serverless Workers](/develop/typescript/workers/serverless-workers)
+{/* SIDEBAR-LIST-END */}