Fix site section ordering so /api URLs resolve correctly

louis-pre · claude · louis-pre · commit 81a58e2b25b4 · 2026-04-21T17:33:07.000-07:00
The catch-all Guides section (urlPrefix: '') was listed first, causing
all /api/... URLs to match Guides instead of API Reference. Reorder
so more-specific prefixes come first.

Co-Authored-By: Claude Opus 4.6 (1M context) &lt;noreply@anthropic.com&gt;
diff --git a/codegen/lib/config.ts b/codegen/lib/config.ts
@@ -16,13 +16,15 @@ export interface SiteSection {
   urlPrefix: string
 }
 
+// Order matters: more-specific prefixes must come first so that URL matching
+// picks the longest prefix (e.g., '/api' before the catch-all '').
 export const siteSections: SiteSection[] = [
-  { name: 'Guides', root: join('docs', 'guides'), urlPrefix: '' },
   {
     name: 'API Reference',
     root: join('docs', 'api-reference'),
     urlPrefix: '/api',
   },
+  { name: 'Guides', root: join('docs', 'guides'), urlPrefix: '' },
 ]
 
 // Convenience accessors (used by codegen)

Original file line number	Diff line number	Diff line change
`@@ -16,13 +16,15 @@ export interface SiteSection {`
`16`	`16`	`urlPrefix: string`
`17`	`17`	`}`
`18`	`18`
	`19`	`+// Order matters: more-specific prefixes must come first so that URL matching`
	`20`	`+// picks the longest prefix (e.g., '/api' before the catch-all '').`
`19`	`21`	`export const siteSections: SiteSection[] = [`
`20`		`- { name: 'Guides', root: join('docs', 'guides'), urlPrefix: '' },`
`21`	`22`	`{`
`22`	`23`	`name: 'API Reference',`
`23`	`24`	`root: join('docs', 'api-reference'),`
`24`	`25`	`urlPrefix: '/api',`
`25`	`26`	`},`
	`27`	`+ { name: 'Guides', root: join('docs', 'guides'), urlPrefix: '' },`
`26`	`28`	`]`
`27`	`29`
`28`	`30`	`// Convenience accessors (used by codegen)`