Fix list: what to fix next

The Fix list turns what your readers run into into one ranked list of things to fix: the section where they give up, the search that finds nothing, the question nobody answers, the moment a video loses them, the link that goes nowhere. Each item shows its evidence and can draft a concrete fix for you to review in the editor.

Open a guide and choose Fix list in the bar at the top. The number beside it is how many items are open. It's built from Insights, so it's on for every guide with Insights on, with nothing to set up.

The list is checked again every day, and when you open it after a day without a check. Editors can choose Check now.

Each item has an impact: the readers it affects (the readers who left at that section, the searches that found nothing, the viewers lost), times how serious that kind of problem is, times how recent it is (evidence from two weeks ago counts half). The biggest impact comes first, marked High impact, Medium or Low.

Nothing is flagged on a handful of visits. Each kind of item needs a minimum before it shows (a page needs 25 measured readers before its sections are judged, a video 8 plays), and each item says how sure it is: Confident, Likely or Early signal. Pages and videos still collecting show under Needs more readers, with how far along they are.

Filter by status (To fix, Fixed, Dismissed, All), by kind of item, or by page.

Choose an item to see why it's there. A section drop shows how far readers got down the page, section by section, with the one where they leave marked. A video shows how many viewers are still watching at each moment. Searches and questions show the wordings readers used, and "not helpful" pages their comments.

In an item, choose Draft a fix (its label says what it does: Rewrite the section, Write an answer, Fix the link). The AI reads the evidence and the page and proposes a concrete edit:

• a rewrite of the section readers leave, or of the page readers marked not helpful, using their comments;
• a new section at the end of the page that answers what readers searched for or asked, or the outline of a new page when nothing covers it;
• the broken link pointed at the page that looks like the right one;
• for a stale or long page, a list of what to check or how to split it.

You see it as a change, line by line. Choose Open in editor: the page opens with the fix offered as a suggestion over the section it rewrites. Accept puts it in the page, where you can keep editing; Discard drops it. A new page outline has Create the page instead. Where the AI doesn't know a fact, it leaves a placeholder in square brackets for you to fill in.

Nothing is published until you publish. Once you accept a fix, the item is In progress; the next publish that changes that page marks it Fixed.

Each draft uses one of the guide's monthly AI uses, shared with Ask AI and the editor's AI help (limits). A link fix and a hidden page's advice don't use any. A draft stays on the item, so opening it again costs nothing; Draft again asks for a new one.

• Start marks an item In progress.
• Mark fixed closes it. If the problem comes back (readers keep leaving there in the days after, or the next publish still has the broken link), it reopens and says Came back.
• Dismiss asks why: Not a problem, Won't fix, Duplicate or something else, with an optional note. A dismissed item stays dismissed.
• An open item that isn't seen for a week closes itself.

On the Guides home, a live guide's card shows how many things it has to fix.

A guide with no readers yet says what the list watches. Choose See a sample Fix list to see it with fictional data, so you know what to expect before traffic arrives.

Assistants like ChatGPT, Claude and Perplexity, and the tools your readers use, read docs too, often more than people do. The Fix list counts them apart from readers, never as one, and shows them in AI agents: how many reads, from which assistants, and how (pages, Markdown, llms.txt, MCP).

An agent read is a page loaded by a known AI agent, or any request for a page's Markdown version, llms.txt or the docs MCP server. Kept: the page, how it was read, and the assistant's family (like "Claude" or "Other tool"). Not kept: its address or its full user agent.

The Fix list follows the same rules as Insights, and some stricter ones:

When a reader's browser sends Do Not Track or Global Privacy Control, none of this is sent at all. A page view sends one small request, when the reader leaves the page. Turning Insights off stops it, and deleting Insights' data deletes the Fix list too.