From 25058fc42ec1e31b503e169d01b27b51cb5dbce0 Mon Sep 17 00:00:00 2001 From: Pratyush Sharma <56130065+pratyush618@users.noreply.github.com> Date: Fri, 10 Jul 2026 21:18:33 +0530 Subject: [PATCH 1/2] docs: drop first paragraph that duplicated the lead The frontmatter description already renders as the page lead; 16 pages repeated it verbatim (or near-verbatim) as the first body paragraph. --- docs/content/docs/architecture/job-lifecycle.mdx | 2 -- docs/content/docs/java/guides/core/index.mdx | 2 -- docs/content/docs/java/guides/reliability/index.mdx | 2 -- docs/content/docs/node/guides/core/index.mdx | 2 -- docs/content/docs/node/guides/reliability/index.mdx | 2 -- docs/content/docs/python/api-reference/overview.mdx | 2 -- docs/content/docs/python/api-reference/queue/events.mdx | 2 -- docs/content/docs/python/api-reference/queue/index.mdx | 2 -- docs/content/docs/python/api-reference/queue/jobs.mdx | 2 -- docs/content/docs/python/getting-started/quickstart.mdx | 2 -- docs/content/docs/python/guides/advanced-execution/index.mdx | 2 -- docs/content/docs/python/guides/core/index.mdx | 2 -- docs/content/docs/python/guides/extensibility/index.mdx | 2 -- docs/content/docs/python/guides/observability/index.mdx | 2 -- docs/content/docs/python/guides/reliability/index.mdx | 2 -- docs/content/docs/python/more/examples/index.mdx | 2 -- 16 files changed, 32 deletions(-) diff --git a/docs/content/docs/architecture/job-lifecycle.mdx b/docs/content/docs/architecture/job-lifecycle.mdx index d465eb99..bd343713 100644 --- a/docs/content/docs/architecture/job-lifecycle.mdx +++ b/docs/content/docs/architecture/job-lifecycle.mdx @@ -3,8 +3,6 @@ title: Job Lifecycle description: "Every job moves through a state machine from creation to completion (or death)." --- -Every job moves through a state machine from creation to completion (or death). - ## Key transitions diff --git a/docs/content/docs/java/guides/core/index.mdx b/docs/content/docs/java/guides/core/index.mdx index 21f35f06..b3caa304 100644 --- a/docs/content/docs/java/guides/core/index.mdx +++ b/docs/content/docs/java/guides/core/index.mdx @@ -3,8 +3,6 @@ title: Core description: "The building blocks of every Java taskito application." --- -The building blocks of every taskito application. - The Queue API is split across several pages for readability: diff --git a/docs/content/docs/python/api-reference/queue/jobs.mdx b/docs/content/docs/python/api-reference/queue/jobs.mdx index a4b560da..f8084e7a 100644 --- a/docs/content/docs/python/api-reference/queue/jobs.mdx +++ b/docs/content/docs/python/api-reference/queue/jobs.mdx @@ -3,8 +3,6 @@ title: Job Management description: "Methods for retrieving, filtering, cancelling, archiving, and replaying jobs." --- -Methods for retrieving, filtering, cancelling, archiving, and replaying jobs. - ## Job retrieval ### `queue.get_job()` diff --git a/docs/content/docs/python/getting-started/quickstart.mdx b/docs/content/docs/python/getting-started/quickstart.mdx index 6c9f99f4..b4fb59b5 100644 --- a/docs/content/docs/python/getting-started/quickstart.mdx +++ b/docs/content/docs/python/getting-started/quickstart.mdx @@ -5,8 +5,6 @@ description: "Build your first task queue in 5 minutes." import { Tab, Tabs } from "fumadocs-ui/components/tabs"; -Build your first task queue in 5 minutes. - ## 1. Define tasks Create a file called `tasks.py`: diff --git a/docs/content/docs/python/guides/advanced-execution/index.mdx b/docs/content/docs/python/guides/advanced-execution/index.mdx index c6b87cbd..12efa6e9 100644 --- a/docs/content/docs/python/guides/advanced-execution/index.mdx +++ b/docs/content/docs/python/guides/advanced-execution/index.mdx @@ -3,8 +3,6 @@ title: Advanced execution description: "Patterns for scaling and optimizing task execution." --- -Patterns for scaling and optimizing task execution. - Date: Fri, 10 Jul 2026 21:18:34 +0530 Subject: [PATCH 2/2] feat(docs): number top-level on-this-page TOC entries Auto-number top-level entries via a CSS counter and strip any authored N. prefix so it isn't doubled; sub-headings keep their dot marker. --- docs/app/components/docs/toc.tsx | 5 ++++- docs/app/styles/docs.css | 14 ++++++++++++++ 2 files changed, 18 insertions(+), 1 deletion(-) diff --git a/docs/app/components/docs/toc.tsx b/docs/app/components/docs/toc.tsx index 65903880..407c59bd 100644 --- a/docs/app/components/docs/toc.tsx +++ b/docs/app/components/docs/toc.tsx @@ -101,7 +101,10 @@ export function Toc() { href={`#${h.id}`} className={`toc-link ${h.level === 3 ? "sub" : ""} ${h.id === active ? "active" : ""}`.trim()} > - {h.text} + {/* Top-level entries are auto-numbered by CSS counter; strip any + authored "N." prefix (some pages number their own headings) so + the number isn't shown twice. */} + {h.level === 2 ? h.text.replace(/^\d+[.)]\s+/, "") : h.text} ))} diff --git a/docs/app/styles/docs.css b/docs/app/styles/docs.css index ff7192a4..9f68d47c 100644 --- a/docs/app/styles/docs.css +++ b/docs/app/styles/docs.css @@ -1239,6 +1239,11 @@ body { width: 14px; height: 14px; } +/* Top-level entries are auto-numbered (1., 2., …) from a counter; sub-headings + use a dot instead (below). The counter resets per page. */ +#toc-list { + counter-reset: toc-section; +} .toc-link { display: block; font-size: 13px; @@ -1250,6 +1255,15 @@ body { border-color 0.15s; cursor: pointer; } +.toc-link:not(.sub) { + counter-increment: toc-section; +} +.toc-link:not(.sub)::before { + content: counter(toc-section) ". "; + color: var(--dim); + font-family: var(--mono); + font-size: 11px; +} .toc-link:hover { color: var(--txt); }