From 9b760b1e8b4f5c940d6697f9d80b4de44555949e Mon Sep 17 00:00:00 2001 From: Andy Stark Date: Mon, 10 Aug 2026 13:26:21 +0100 Subject: [PATCH] DOC-6954 Give the Client tools page its categories back One deleted line. `categories:` had no value and `aliases:` sat immediately beneath it, so YAML bound the category list to `aliases` and left `categories` null. Removing the stray key restores the list to where it was written. Commit daf2053e2, during the DOC-4543 restructure, inserted `aliases: ` on the line between `categories:` and its list. Before that the frontmatter was correct. So this was never a mistyped category list -- a new key landed one line too high and took the existing list with it, silently, and nothing in the build noticed for twenty-one months. Inserting any key directly above a block list does the same thing. Two effects, both verified against a full build with a production baseURL. The AI outputs get their tags back. The per-page JSON and the Markdown metadata block both derive `tags` from categories, so this page had been publishing an empty array to every consumer of the feed; it now carries all nine entries. Seven bogus redirects stop being published. Because Hugo resolves a slash-less alias against the declaring page's parent directory, the category words had been publishing stubs at /develop/develop/, /develop/docs/, /develop/kubernetes/, /develop/oss/, /develop/rc/, /develop/rs/ and /develop/stack/, all pointing at /develop/tools/. All seven are gone from the build. Removing them is safe: nothing in content, layouts or static references any of them, and Hugo's stubs carry robots noindex, so they were never indexed either. The list is restored verbatim, duplicate `oss` included. That duplicate looked like a typo worth tidying until I counted: 822 pages carry this exact nine-entry list, and 857 of 4,696 category lists contain some duplicate. It is the house pattern, and removing it here would make this page the odd one out for no benefit. One correction to the ticket, which claimed the page was missing from its category listings. It was not, because there are no category listings: layouts/_default/term.html and taxonomy.html both contain only a comment suppressing Hugo's missing-layout warning, so every category page renders one byte. The real cost of the bug was the empty tags array and the seven spurious redirects, not navigation. Learned: the stated impact was wrong in a way only the built output showed -- category listing pages render nothing at all here, so the cost was to the machine-readable outputs rather than to anything a reader sees Constraint: the duplicate `oss` in this category list is deliberate house style shared by 822 pages, not a typo to tidy Ticket: DOC-6954 Co-Authored-By: Claude Opus 5 (1M context) --- content/develop/tools/_index.md | 1 - 1 file changed, 1 deletion(-) diff --git a/content/develop/tools/_index.md b/content/develop/tools/_index.md index 61ba1a1659..7cb1f84063 100644 --- a/content/develop/tools/_index.md +++ b/content/develop/tools/_index.md @@ -1,6 +1,5 @@ --- categories: -aliases: - docs - develop - stack