From adf43dffc04bf26d8797322b4ad0d44ca82d1aae Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Miguel=20=C3=81ngel?= Date: Wed, 23 Sep 2026 01:50:00 -0400 Subject: [PATCH] docs(catalog): shorten the sectionEntry comment under the 4-line cap --- scripts/generate-catalog-pages.ts | 13 ++++--------- 1 file changed, 4 insertions(+), 9 deletions(-) diff --git a/scripts/generate-catalog-pages.ts b/scripts/generate-catalog-pages.ts index b7a4ae6e60..bf16a1a35c 100644 --- a/scripts/generate-catalog-pages.ts +++ b/scripts/generate-catalog-pages.ts @@ -794,15 +794,10 @@ function tunableVariables(kind: ItemKind, manifest: RegistryItem): ItemVariable[ return file ? (declaredVariables(file.source) as ItemVariable[]) : []; } -/** - * One section's sidebar entry, from its section label and the shelves it wraps. - * A section wrapping exactly one shelf of the SAME name (e.g. "3D motion" wrapping - * only "3D motion") would otherwise nest an identical label inside itself — the - * accordion header and its one child would read the same word twice. Flatten that - * case to the shelf's own pages; a section wrapping a differently-named shelf (e.g. - * "Data & charts" wrapping "Data") keeps the nested shelf, since both labels carry - * distinct meaning in the sidebar. - */ +// One section's sidebar entry. A section wrapping exactly one identically-named +// shelf (e.g. "3D motion") flattens to that shelf's own pages, or the accordion +// header and its one child read the same word twice; a differently-named single +// child (e.g. "Data & charts" wrapping "Data") keeps its nested shelf. export function sectionEntry( section: string, children: { group: string; pages: unknown[] }[],