Broken pages changelog
Claims and links that stopped being true — found before a reader finds them. This is the Broken pages slice of the full Docsbook changelog; an entry appears here whenever what it shipped moves this number, whichever part of the panel it landed in.
NEW - 02.09.2026#
Changed#
- The setup checklist now opens with an audit instead of an interview: the first step files what is actually wrong with your generated draft as issues you can work through one at a time, rather than asking you what is missing before you have had a chance to find out.
NEW - 31.08.2026#
Improved#
- Reviewing an AI-proposed change in
AI Chatnow shows each file's diff collapsed by default, so a multi-file proposal reads as a scannable list of files first instead of an unbroken wall of diffs, and the card itself now picks up your workspace's own accent color instead of a flat neutral background.AI Chat
Fixed#
- Header navigation links on a docs site served at an apex path (like
docsbook.io/docs) no longer 404 — they used to resolve against the site root instead of the site's own base path, so a link meant for that site could bounce through a subdomain that doesn't exist.Changes
NEW - 30.08.2026#
Added#
- Your agent can now ask one question and get a checked answer back. Nineteen scenario tools each answer a single question about your docs — which pages are one edit away from traffic they already rank for (
audit_seo), why traffic fell and what was ruled out (diagnose_traffic_drop), which pages you do not have yet (find_content_gaps), whether a change actually worked (verify_change_impact), whether answer engines can quote you (audit_geo), and fifteen more — each returning a structured answer instead of a paragraph to read.MCP - The public prompt catalog gained two ways to browse them: Audits & diagnosis, for the sentences that ask what is wrong and what the fix would cost, and Background agents, for the ones that start work you come back to.
MCP - The same Improve button now sits on every goal in
Goals & funnelsand on each step of a funnel, including beside the note that names where a route breaks, so a number that looks wrong is one click from an explanation of why.Goals & funnels - An open conversation on the
Chatpage now has Analyze, which reads the transcript for the turn where it went wrong and separates the three causes that look alike: the answer is not in your docs, it is there and was not found, or it was found and reads badly.AI Chat - An open conversation on the
Chatpage now has Improve beside Analyze. Analyze reads the transcript for where it went wrong; Improve answers the other question — what to change in your docs so the next reader asking this does not need the chat at all, named at the right layer: a page that should exist, a link that should have connected two pages, or a retrieval problem no rewrite will solve.AI Chat - Six more of them: which numbers you already hold that nobody outside could obtain at any price, and which clear a privacy and contractual gate (
assess_research_assets); whether a stranger would ever cite one of your pages, and which inbound links now arrive at something broken (audit_linkability); which repeated questions reach a person that a page would have closed, ranked by how many different people asked (assess_support_deflection); which third-party tools readers try to use you with and you never mention (map_integration_demand); what an evaluator on a named incumbent cannot find (assess_competitor_switching); and what shipped and stayed invisible (audit_release_adoption).MCP - Fourteen more scenario tools, one for each method already written in the skills catalog that no tool answered. Why the assistant cannot find an answer that IS on the page (
audit_retrieval). Which settings are on and doing nothing, checked against the live site rather than the switch (audit_site_config). Which pages are really tables served as prose, with the widget from your own catalogue that fixes each (design_page_widgets). Which pages the last release made wrong (diagnose_docs_drift).MCP - And ten more: what should keep happening without anybody remembering, and whether each check belongs in a hook or in CI (
plan_automation_workflows); which of these tools your workspace can answer with at all, and the cheapest thing to connect (assess_setup_readiness); the material you already have that could be docs, support answers and community threads included (map_content_sources); whether this kind of change has ever worked here before you repeat it (assess_fix_precedent); which two to four tools your question actually calls for (plan_audit_route); what each number is worth to the business (map_business_value); whether the corpus reads as an authority or as a site that mentions a topic (map_topic_authority); the region readers can only reach from the sidebar (audit_internal_links); which languages are read and which translations are behind their source (audit_translation_coverage); and what shape of answer a query wanted against what the ranking page delivers (diagnose_intent_mismatch).MCP - Forty-two more worked examples in the
MCPcatalog, and ten existing prompts now call one of the new tools where it changes the answer — the unanswered-questions prompt now splits "the page is missing" from "the page exists and nothing can retrieve it", and the striking-distance prompt now says whether the page is simply the wrong shape for the query.MCP
Changed#
diagnose_intent_mismatchwas being quoted at the wrong price and the wrong wait, because both rate tables matched the bare word "intent" from an older, single-tool rule. It is an agent run and now says so — a caller told to expect a few seconds would have given up on something that takes minutes.MCP
Fixed#
- Approving proposed changes in a review card now reliably applies them. The assistant previously had to retype every approved file's full text from scratch to commit it, and on a large batch it could refuse the whole thing rather than risk getting that copy wrong. Approved changes are now committed straight from the proposal you reviewed, so nothing is retyped and nothing is refused.
AI Chat
NEW - 22.08.2026#
Fixed#
www.docsbook.ionow redirects to the apex domain instead of showing a 404.Marketing
NEW - 21.08.2026#
Fixed#
- A link copied straight from GitHub's file view now opens on your docs domain instead of 404ing, so pasting
.../blob/main/READMEworks without hand-editing the path.Docs
NEW - 14.08.2026#
Fixed#
Start new projectfrom a workspace subdomain no longer 404s, and the project switcher no longer doubles the organisation in its path.AI Chat
NEW - 10.08.2026#
Fixed#
- Plans on
/pricingcould not be bought: the upgrade CTAs dropped the plan you picked, and the two top tiers were sold with the wrong AI budget.Pricing - A repository preview opened on a workspace subdomain returned a 404 when you sent a message.
Draft
NEW - 07.08.2026#
Changed#
- Each report in
Analytics Explorernow renders in the shape its data means, so there is no chart-type menu to get wrong, and every row carries an icon you can scan for.Analytics
Fixed#
- Switching the doc language from inside a subfolder no longer leads to a 404 page.
Docs
NEW - 29.07.2026#
Fixed#
- Clicking a page link inside an anonymous draft at
docsbook.io/draftno longer redirects to a brokendraft.docsbook.iosubdomain.Preview
NEW - 28.07.2026#
Added#
- Content health merges the relationship graph, semantic index and findings into one card that names orphan pages, meaning-duplicates, broken links, unread pages and key hubs, each with a concrete next step.
Analytics
NEW - 17.07.2026#
Fixed#
- A doc URL with different letter casing than the source file now redirects to the canonical URL instead of 404ing.
SEO
NEW - 14.07.2026#
Fixed#
- Per-page social preview images on client doc sites, previously broken (404) on every page except the repo root.
Social Preview
0.26.5 - 29.06.2026#
Improved#
- The "Go to website" link after publishing now waits until your site is actually live, showing a brief "deploying" state instead of opening a page that 404s for the first few minutes.
Publishing
0.22.3 - 30.05.2026#
Fixed#
- Fix
/pricingroute returning 404 — now redirects to/instead of brokenpricing.docsbook.iosubdomain
0.22.1 - 28.05.2026#
Fixed#
- Fixed broken navigation on
docs.docsbook.ioalias — clicking any sidebar/inline link returned 404 because cached HTML carried the/docs/repo prefix while middleware rewrote it again. Addedx-docs-aliasheader insrc/proxy.tsand routedbasePathto empty insrc/app/[user]/[repo]/[[...path]]/page.tsxso links render as/ai/mcpinstead of/docs/ai/mcp. Existingdocsbook-io.docsbook.io/docs/*paths keep working unchanged
0.18.0 - 24.05.2026#
Fixed#
- AI Skills cards in the admin no longer 404 on workspace subdomains — clicking a card now opens an in-place modal with the full
SKILL.md(description, install snippets for 7 AI clients, keywords, MCP tools, GitHub link) instead of routing to/skills/<name>which only exists ondocsbook.io. Landing-page behavior is unchanged
Removed#
- Broken
SearchActionfrom the landing JSON-LD — it pointed at/search?q=, a page that does not exist, sending a negative signal to Google instead of unlocking the Sitelinks Search Box
0.17.4 - 23.05.2026#
Fixed#
- Replaced broken
(#)CTA links across 5 blog posts (mintlify-vs-docsbook,docusaurus-vs-docsbook,why-documentation-matters,documentation-seo-guide,ai-search-documentation) — all now point tohttps://docsbook.io/start
0.16.0 - 22.05.2026#
Fixed#
/connecton a workspace subdomain now redirects todocsbook.io/connectinstead of 404ConnectPagenow redirects to sign-in when the session cookie is present but invalid/expired, preventing a brokenConnectPickerstate- Workspace redirect after sign-in always uses
APP_DOMAINinstead of the requesthostheader, preventing wrong subdomain redirects