zudo-doc
GitHub repository

Type to search...

to open search from anywhere

12.0.0

Created Nov 13, 2026Claude

Release notes for 12.0.0.

Released: 2026-11-13

Breaking Changes

  • zudoDoc() now throws a TypeError when the settings still contain findInPage, the key that 11.0.0 removed, instead of ignoring it. The message tells you to remove the key. Configs without findInPage are unaffected. (#4763)

  • The @takazudo/zudo-doc-history-server peer floor moves from ^11.0.0 to ^12.0.0. Projects that enable document history need history-server 12.x.

Features

  • Pages that exist as real content in more than one locale now link each other with <link rel="alternate" hreflang> after the canonical link, including a self-reference and x-default for the default-locale page, and the sitemap lists the same pairs as xhtml:link alternates. This covers the home pages and latest document pages; fallback-only, versioned and tag pages stay unpaired. Nothing changes without siteUrl or on single-locale sites. @takazudo/zudo-doc/route-enumerators adds getDocLocaleAlternates and getHomeLocaleAlternates, and sitemap entries gain an optional alternates field. (#4787)

Bug Fixes

  • The sitemap's <lastmod> is now each document page's last-updated date from document history, the same date as its "Updated" label, instead of the build date on every URL. Routes with no known date (home and locale roots, tag, asset and versioned pages, or any page while docHistory is off or document history generation is skipped) have no <lastmod>. @takazudo/zudo-doc/route-enumerators adds enumerateSitemapEntries; enumerateAllRoutes is unchanged. (#4784)

  • Page URLs in llms.txt, llms-full.txt, the browser search index (search-index.json), the agent export (manifest, items, search index) and MCP search/fetch results now follow the trailingSlash setting, the same as the built routes. With trailingSlash: true they end with / and no longer cite a URL that redirects; with trailingSlash: false output is unchanged. The schemas are unchanged and agent page IDs stay the same, but the url values, the llms.txt bytes and the agent corpus fingerprint change for sites with trailingSlash: true. (#4783)

  • MCP search result titles name the part of a multi-part page once, for example Read-only MCP server (en · part 1/2) instead of Read-only MCP server (part 1/2) (en · part 1/2). Stored item titles and fetch results are unchanged. (#4783)

  • /mcp no longer approves the opaque Origin: null when siteUrl has no http: or https: scheme (for example docs.example.com:8443). Only an http(s) siteUrl adds an approved origin; requests without Origin and requests from the endpoint's own origin behave as before. (#4783)

  • The agent export (/agent/v1/ pages, items and search index) now turns admonitions, <Details> and <TabItem> into a bold label such as **Note: Title** followed by their body, and renders <CategoryNav>, <CategoryTreeNav>, <SiteTreeNav>, <DocCardNav> and <NoteTrayIndex> as Markdown link lists of the same locale's exported pages. These pages are no longer marked unsupportedDynamicContent. Other components, and components whose props are not plain literals, still become a placeholder that now names the component, for example [Dynamic content unavailable in text export: MathBlock], and keep the flag. Item text and the corpus fingerprint change for pages that use these components. llms-full.txt is unchanged. (#4786)

Revision History

ClaudeCreated: 2026-11-13T17:01:48ZUpdated: 2026-11-13T17:01:48Z

AI Assistant

Ask a question about the documentation.

Preview theme

Loading theme previews…