Bugbash fixes

[zastrowm]

Description

Note: This is targeting the workstream/cms-migration branch.

---

Address the bug-bash reports with a handful of fixes and polish across the sidebar, pagination, and build pipeline.

Route middleware / navigation:

• Pages with no matching nav section (e.g. landing page) now show an empty sidebar instead of the full sidebar
• Prev/next pagination links are now pruned to stay within the current nav section — no more bleeding across User Guide / Community / Examples boundaries
• Pagination labels now use actual page titles instead of sidebar nav labels (e.g. "Amazon Bedrock" instead of "amazon-bedrock")

Link resolution:

• PageLink.astro now correctly strips the site base path before resolving relative links, then re-applies it — fixes broken links when deployed under a sub-path

Build / config:

• Expressive Code themeCssSelector now follows Starlight's [data-theme] attribute so code block themes stay in sync with the site theme toggle
• Added processedDirs pointing at .build/api-docs so Starlight's rehype plugins (heading anchors, etc.) run correctly on symlinked API docs
• Both API generation scripts now emit editUrl: false in frontmatter to suppress "Edit this page" on generated files
• typedoc.json: added excludeExternals: true to keep re-exported external symbols out of the TS API reference

The following are temporary migration scripts — no need to review unless something looks glaringly wrong: scripts/update-docs.ts, scripts/update-quickstart.ts.

Migration script (update-docs.ts):

• Collapsible admonitions (??? and ???+) are now converted alongside standard !!! blocks
• Bidi pages no longer get an experimental sidebar badge (it was being double-applied)

Related Issues

#441

Type of Change

• Bug fix

Checklist

• I have read the CONTRIBUTING document
• My changes follow the project's documentation style
• I have tested the documentation locally using mkdocs serve
• Links in the documentation are valid and working

---

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

[github-actions]

Documentation Preview Ready

Your documentation preview has been successfully deployed!

Preview URL: https://d3ehv1nix5p99z.cloudfront.net/pr-cms-575/user-guide/quickstart/overview/

Updated at: 2026-02-21T04:20:56.884Z