---
title: "Doc health and freshness"
url: "/help/buuk/doc-health-and-freshness"
updated: "2026-11-13T13:32:19.354Z"
---
# Doc health and freshness

Doc health and Freshness are the maintenance side of your help center. Reporting shows what readers did; these two pages show which articles need work.

## Doc health

Open **Doc health** from the dashboard sidebar. It measures one thing: how readers vote on published articles. Traffic, tickets, and how recently a page changed are not part of it.

- **Helpful rate** — the share of votes that were thumbs-up in the selected period.
- **Helpful votes** and **Unhelpful votes** — the raw counts behind the rate.
- **Articles to fix** — published articles with at least one thumbs-down.

Below the numbers, **Unhelpful articles** lists each page readers voted down. Queue a fix and Buuk files it in [Suggestions](./suggested-updates), where support themes about the same topic also land. Pick the period at the top: past 7, 30, or 90 days, all time, or a custom range.

## Freshness

Open **Freshness** to catch articles before readers see outdated content. A daily freshness job scores every published article; until it has run once, the page says no freshness data yet.

- **Current** — still matches the product.
- **Aging** — starting to feel dated.
- **Stale** — likely describes an older version of the product.

Filter the queue by group, and sort by lowest score, most views, or oldest update. Open an article to see **Why this needs a look** — its last edit, views, and reader feedback. Then either confirm it with **Mark verified** or choose **Edit article** to fix it. The **Views at risk** number shows how much traffic is landing on pages that need review, so start with the busiest ones.

You can change when the review runs in [Automations](./automations): the **Freshness review** automation runs daily by default, in the workspace timezone from Settings → General.

## Agent readiness

How easily AI tools can read your docs lives in **Reporting → AI answers**, with readiness over time and a queue of concrete fixes. See [Reporting](./reporting-doc-health-and-freshness).

> [!TIP]
> Verify high-traffic pages first. A weekly pass through Freshness keeps the queue short.