> For the complete documentation index, see [llms.txt](https://ascribed-dev.com/docs/llms.txt). This documentation describes Ascribe 0.4.4. Anything marked in main, not yet released isn't in that release yet.

# Diagnostics: content checks across the project

> Reference · The checks of a project as a whole, such as orphan pages, what's unused, and release lines, which it can set the level of or turn off.

The content checks of the project as a whole: what nothing uses or links to, what two pages share, and what a [release line](https://ascribed-dev.com/docs/glossary.md#release-line) marks. The checks of pages are on [Diagnostics: content checks](https://ascribed-dev.com/docs/checks/diagnostics/content-checks.md), which says how a project sets a check's level or turns it off in [`[checks]`](https://ascribed-dev.com/docs/content-model/checks.md#22-checks), and the checks of outputs, prose, external links, the published site, and tested examples are on [Diagnostics: content checks of outputs and the site](https://ascribed-dev.com/docs/checks/diagnostics/output-checks.md). Part of the [diagnostics reference](https://ascribed-dev.com/docs/checks/diagnostics.md), which says what an entry's severity, level, and next step mean, and has an index of every diagnostic.

These checks need every page, so the editor reports a page's orphan and duplicate title, and what's unused, when you save, and the checks of image files run only in `ascribe check`. `release-line-ended` depends on the day, so `ascribe check` can report it on one day and not the day before: see [Checking as of another day](https://ascribed-dev.com/docs/checks/check.md#checking-as-of-another-day).

## Across the project

### ASC154 `page-orphan`

[Advice](https://ascribed-dev.com/docs/checks/diagnostics.md#severity) · [page level](https://ascribed-dev.com/docs/checks/diagnostics.md#file-level-and-page-level) · next step: [review](https://ascribed-dev.com/docs/checks/diagnostics.md#what-to-do-next) · [configurable](https://ascribed-dev.com/docs/checks/diagnostics.md#setting-a-checks-level) in `[checks]` · [acknowledged](https://ascribed-dev.com/docs/glossary.md#acknowledgement) in the page's `intended` frontmatter · [SPEC §5.2](https://github.com/ascribed-dev/ascribe/blob/main/SPEC.md#52-links)

**When:** No other page the build publishes links to the page or includes it. Index pages (`index.md`), and a build's only page, aren't reported. The message says what reaches the page: only the sidebar, or, for a page that's `unlisted`, nothing but its address.

**Message:** no other page links to this page or includes it, so readers reach it only through the sidebar

**Fix:** Link to the page from a page about its topic, or include it in one, so a reader of that page finds it. A page in the navigation is still in the sidebar, so this is a hint: acknowledge one that needs no link in its `intended` frontmatter, or turn the check off in [`[checks]`](https://ascribed-dev.com/docs/content-model/checks.md#22-checks) (`page-orphan = "off"`). A page that's `listing: unlisted` is in no sidebar, so only someone given its address reaches it: link to it, or take `listing: unlisted` away to put it in the sidebar.

**Read more:** [Links](https://ascribed-dev.com/docs/writing/inline.md#links) in the phrases and links reference.

### ASC155 `fragment-unused`

[Advice](https://ascribed-dev.com/docs/checks/diagnostics.md#severity) · [file level](https://ascribed-dev.com/docs/checks/diagnostics.md#file-level-and-page-level) · next step: [review](https://ascribed-dev.com/docs/checks/diagnostics.md#what-to-do-next) · [configurable](https://ascribed-dev.com/docs/checks/diagnostics.md#setting-a-checks-level) in `[checks]` · [acknowledged](https://ascribed-dev.com/docs/glossary.md#acknowledgement) in the page's `intended` frontmatter · [SPEC §4.2](https://github.com/ascribed-dev/ascribe/blob/main/SPEC.md#42-include)

**When:** No file includes the [fragment](https://ascribed-dev.com/docs/glossary.md#fragment).

**Message:** no file includes this fragment, so nothing publishes it

**Fix:** Include the fragment where it belongs with `@include`, or delete it when nothing needs it any more.

**Read more:** [`@include`](https://ascribed-dev.com/docs/writing/directives.md#include) in the directive reference.

### ASC156 `phrase-unused`

[Advice](https://ascribed-dev.com/docs/checks/diagnostics.md#severity) · [file level](https://ascribed-dev.com/docs/checks/diagnostics.md#file-level-and-page-level) · next step: [review](https://ascribed-dev.com/docs/checks/diagnostics.md#what-to-do-next) · [configurable](https://ascribed-dev.com/docs/checks/diagnostics.md#setting-a-checks-level) in `[checks]` · [acknowledged](https://ascribed-dev.com/docs/glossary.md#acknowledgement) in `[[intended]]` · [SPEC §5.1](https://github.com/ascribed-dev/ascribe/blob/main/SPEC.md#51-phrases)

**When:** No file writes the phrase, in its text or in a frontmatter field that takes phrases.

**Message:** no file uses the phrase `{key}`

**Fix:** Write the phrase where its value belongs, or remove it from `[phrases]`. A phrase is used wherever a page or a fragment writes its key in braces, in the text or in a frontmatter field that takes phrases.

**Read more:** [`[phrases]`](https://ascribed-dev.com/docs/content-model/content.md#7-phrases) in the `ascribe.toml` reference.

### ASC157 `feature-unused`

[Advice](https://ascribed-dev.com/docs/checks/diagnostics.md#severity) · [file level](https://ascribed-dev.com/docs/checks/diagnostics.md#file-level-and-page-level) · next step: [review](https://ascribed-dev.com/docs/checks/diagnostics.md#what-to-do-next) · [configurable](https://ascribed-dev.com/docs/checks/diagnostics.md#setting-a-checks-level) in `[checks]` · [acknowledged](https://ascribed-dev.com/docs/glossary.md#acknowledgement) in `[[intended]]` · [SPEC §4.4](https://github.com/ascribed-dev/ascribe/blob/main/SPEC.md#44-available)

**When:** No [availability](https://ascribed-dev.com/docs/glossary.md#availability) spec names the feature: no `@available`, table row's `available`, or page's `available`.

**Message:** no file uses the feature `{key}`

**Fix:** Mark the content the feature covers with its key (`@available: <key>`, or `available: <key>` in a page's frontmatter), or remove the feature from `[features]` once nothing needs it.

**Read more:** [`[features.<key>]`](https://ascribed-dev.com/docs/content-model/variation.md#14-featureskey) in the `ascribe.toml` reference.

### ASC158 `glossary-term-unused`

[Advice](https://ascribed-dev.com/docs/checks/diagnostics.md#severity) · [file level](https://ascribed-dev.com/docs/checks/diagnostics.md#file-level-and-page-level) · next step: [review](https://ascribed-dev.com/docs/checks/diagnostics.md#what-to-do-next) · [configurable](https://ascribed-dev.com/docs/checks/diagnostics.md#setting-a-checks-level) in `[checks]` · [acknowledged](https://ascribed-dev.com/docs/glossary.md#acknowledgement) with `@intended` above the block, or under the heading for a heading · [SPEC §5.4](https://github.com/ascribed-dev/ascribe/blob/main/SPEC.md#54-glossary-terms)

**When:** The term, and each of its aliases, appears in no other page's prose, and no link names its heading.

**Message:** the glossary term `{term}` appears in no other file's prose, and no link names its heading, so it's never linked

**Fix:** Check the term and its `aliases` against how the pages write it: occurrences match whole words, in prose only, and ignore case unless the term is case-sensitive. Remove the term when the pages don't need it. A term with `match = "marked"` is used only where a link names its heading: link the occurrences that mean it, as `[build](glossary.md#build)`. A term used only inside a phrase's value is reported too, since phrase values aren't searched: acknowledge it with [`@intended`](https://ascribed-dev.com/docs/writing/directives.md#intended) at the top of the term's section, under its heading.

**Read more:** [Terms](https://ascribed-dev.com/docs/content-model/content.md#82-terms) in the `ascribe.toml` reference.

### ASC159 `image-unused`

[Advice](https://ascribed-dev.com/docs/checks/diagnostics.md#severity) · [file level](https://ascribed-dev.com/docs/checks/diagnostics.md#file-level-and-page-level) · next step: [review](https://ascribed-dev.com/docs/checks/diagnostics.md#what-to-do-next) · [configurable](https://ascribed-dev.com/docs/checks/diagnostics.md#setting-a-checks-level) in `[checks]` · [acknowledged](https://ascribed-dev.com/docs/glossary.md#acknowledgement) in `[[intended]]` · [SPEC §5.3](https://github.com/ascribed-dev/ascribe/blob/main/SPEC.md#53-images)

**When:** An image file under the content root that no file shows or links to: no Markdown image or link, no `src`, `srcset`, `href`, or `poster` in raw HTML, and no frontmatter string names it.

**Message:** no file shows or links to `{path}`

**Fix:** Delete the image when nothing needs it. A frontmatter string counts when it names the image from the file or from the content root, as `cover: img/card.png` does. An image used only by the site's own code is reported too, since Ascribe doesn't read it: turn the check off in [`[checks]`](https://ascribed-dev.com/docs/content-model/checks.md#22-checks) when your site uses images that way.

**Read more:** [Images](https://ascribed-dev.com/docs/writing/inline.md#images) in the phrases and links reference.

### ASC160 `image-large`

[Advice](https://ascribed-dev.com/docs/checks/diagnostics.md#severity) · [file level](https://ascribed-dev.com/docs/checks/diagnostics.md#file-level-and-page-level) · next step: [review](https://ascribed-dev.com/docs/checks/diagnostics.md#what-to-do-next) · [configurable](https://ascribed-dev.com/docs/checks/diagnostics.md#setting-a-checks-level) in `[checks]` · [acknowledged](https://ascribed-dev.com/docs/glossary.md#acknowledgement) in `[[intended]]` · [SPEC §5.3](https://github.com/ascribed-dev/ascribe/blob/main/SPEC.md#53-images)

**When:** An image file under the content root is larger than the limit: 500 KB, or `[checks.image-large] limit`.

**Message:** `{path}` is {size}, over the {limit} limit for an image

**Fix:** Make the image smaller: save it at the size it's shown, or compress it (a screenshot as an optimized PNG, a photo as JPEG or WebP). The limit is 500 KB; set another in `ascribe.toml`, such as `[checks.image-large] limit = "1 MB"`.

**Read more:** [`[checks]`](https://ascribed-dev.com/docs/content-model/checks.md#22-checks) in the `ascribe.toml` reference.

### ASC161 `title-duplicate`

[Advice](https://ascribed-dev.com/docs/checks/diagnostics.md#severity) · [page level](https://ascribed-dev.com/docs/checks/diagnostics.md#file-level-and-page-level) · next step: [write](https://ascribed-dev.com/docs/checks/diagnostics.md#what-to-do-next) · [configurable](https://ascribed-dev.com/docs/checks/diagnostics.md#setting-a-checks-level) in `[checks]` · [SPEC §2.2](https://github.com/ascribed-dev/ascribe/blob/main/SPEC.md#22-pages-and-fragments)

**When:** Two pages the build publishes have the same title, ignoring case.

**Message:** `{title}` is also the title of {others}, so readers can't tell the pages apart in search results or a list of pages

**Fix:** Give each page a title that says what sets it apart. When one page replaces the other, remove the old one, or publish only one of them in each build with `available`.

**Read more:** [`[checks]`](https://ascribed-dev.com/docs/content-model/checks.md#22-checks) in the `ascribe.toml` reference.

### ASC172 `availability-left-behind`

[Advice](https://ascribed-dev.com/docs/checks/diagnostics.md#severity) · [file level](https://ascribed-dev.com/docs/checks/diagnostics.md#file-level-and-page-level) · next step: [review](https://ascribed-dev.com/docs/checks/diagnostics.md#what-to-do-next) · [configurable](https://ascribed-dev.com/docs/checks/diagnostics.md#setting-a-checks-level) in `[checks]` · [acknowledged](https://ascribed-dev.com/docs/glossary.md#acknowledgement) in `[[intended]]` · [SPEC §4.4](https://github.com/ascribed-dev/ascribe/blob/main/SPEC.md#44-available)

**When:** A feature's availability names a version for every target, each target lists its lines in `[releases]`, and no version is later than its target's current line.

**Message:** feature `{key}` names releases up to {version}, and the current line of `{target}` is {current}, so what it marks has shipped

**Fix:** When the feature stood for what a release would add, write the shipped release's spec at the content that shipped in it (`@available: ascribe 0.2.0`), and mark what the next release adds `<target> planned` instead of keeping a feature for it. When it's a history worth keeping by name, acknowledge it in [`[[intended]]`](https://ascribed-dev.com/docs/content-model/checks.md#intended-acknowledgements). After each release, move its line from `planned` to `live` in [`[releases.<target>]`](https://ascribed-dev.com/docs/content-model/variation.md#121-releasestarget).

**Read more:** [`[releases.<target>]`](https://ascribed-dev.com/docs/content-model/variation.md#121-releasestarget) in the `ascribe.toml` reference.

### ASC191 `description-duplicate`

[Advice](https://ascribed-dev.com/docs/checks/diagnostics.md#severity) · [page level](https://ascribed-dev.com/docs/checks/diagnostics.md#file-level-and-page-level) · next step: [write](https://ascribed-dev.com/docs/checks/diagnostics.md#what-to-do-next) · [configurable](https://ascribed-dev.com/docs/checks/diagnostics.md#setting-a-checks-level) in `[checks]` · [SPEC §9.4](https://github.com/ascribed-dev/ascribe/blob/main/SPEC.md#94-outputs)

**When:** Two pages the build publishes have the same description, ignoring case.

**Message:** this is also the description of {others}, so a search result, a link preview, and `llms.txt` say the same of each page, and a reader can't tell which one they want

**Fix:** Give each page a description that says what it's for and what sets it apart from the others. When one page replaces the other, remove the old one, or publish only one of them in each build with `available`.

**Read more:** [Field roles](https://ascribed-dev.com/docs/content-model.md#54-field-roles) in the `ascribe.toml` reference.

### ASC211 `available-line-undeclared`

[Advice](https://ascribed-dev.com/docs/checks/diagnostics.md#severity) · [file level](https://ascribed-dev.com/docs/checks/diagnostics.md#file-level-and-page-level) · next step: [choose](https://ascribed-dev.com/docs/checks/diagnostics.md#what-to-do-next) · [configurable](https://ascribed-dev.com/docs/checks/diagnostics.md#setting-a-checks-level) in `[checks]` · [SPEC §4.4](https://github.com/ascribed-dev/ascribe/blob/main/SPEC.md#44-available)

**When:** A version is in a line between two of its target's declared lines, and that line isn't declared.

**Message:** `{version}` is in the line `{line}`, which `[releases.{target}]` doesn't declare; declare it, or correct the number to `{older}` or `{newer}`

**Fix:** Declare the line in `[releases.<target>]`, in the list where it falls: `live` for a line readers are on, `planned` for one newer than every live line that hasn't shipped, or, for one older than every live line that shipped and that nothing publishes now, `archived` with no address, as `"3.3" = {}`. Or correct the number to a declared line, such as the one either side of it.

**Read more:** [`[releases.<target>]`](https://ascribed-dev.com/docs/content-model/variation.md#121-releasestarget) in the `ascribe.toml` reference.

### ASC212 `available-same-in-every-line`

[Advice](https://ascribed-dev.com/docs/checks/diagnostics.md#severity) · [file level](https://ascribed-dev.com/docs/checks/diagnostics.md#file-level-and-page-level) · next step: [write](https://ascribed-dev.com/docs/checks/diagnostics.md#what-to-do-next) · [configurable](https://ascribed-dev.com/docs/checks/diagnostics.md#setting-a-checks-level) in `[checks]` · [SPEC §4.4](https://github.com/ascribed-dev/ascribe/blob/main/SPEC.md#44-available)

**When:** Every version a mark names for its target is at or before the oldest live line and its last state counts as available, so every live line has the content, and no build filtered for the target at a version before the window publishes it: no output shows the versions, or a build that badges availability shows them and they're all before the oldest live line, so the badge says only that the content is older than every live line.

**Message:** `{entry}` names versions every live line of `{target}` has, the oldest being `{oldest}`, so no output shows them; write `{simpler}`

**Fix:** Write the mark without its versions, keeping its state: `self-managed 3.1` becomes `self-managed`, and `self-managed deprecated 3.2` becomes `self-managed deprecated`. Every live line has the content, and a line's output leaves out a version at or before the oldest live line, so where no output shows the versions nothing a reader sees changes. When the mark would be its target alone, generally available, the target is the only value of its [dimension](https://ascribed-dev.com/docs/glossary.md#dimension), no build filters for another target, and the mark names nothing else, the fix removes the mark instead: the `@available` line, the page's `available` key, or the row's `{available=…}`.

Content with no mark reads as the scope around it, so a mark is removed only when no mark around it says something, as a page that's deprecated or a section in preview does, and never in a fragment, which reads as where it's included; there, as everywhere else, the fix rewrites it. In a build that badges availability, which is reported only for versions before the oldest live line, the badge's version goes, or the whole badge with the mark, which changes the page, so the fix isn't safe; a project that keeps such badges, as "new in 0.2", turns the check off in `[checks]`.

**Read more:** [`[releases.<target>]`](https://ascribed-dev.com/docs/content-model/variation.md#121-releasestarget) in the `ascribe.toml` reference.

### ASC213 `available-in-no-line`

[Warning](https://ascribed-dev.com/docs/checks/diagnostics.md#severity) · [file level](https://ascribed-dev.com/docs/checks/diagnostics.md#file-level-and-page-level) · next step: [write](https://ascribed-dev.com/docs/checks/diagnostics.md#what-to-do-next) · [configurable](https://ascribed-dev.com/docs/checks/diagnostics.md#setting-a-checks-level) in `[checks]` · [SPEC §4.4](https://github.com/ascribed-dev/ascribe/blob/main/SPEC.md#44-available)

**When:** Every build that publishes a mark's content is versioned by its target, or filtered for it at a version in the window or after it, and the content is in no live or planned line of the target.

**Message:** `{entry}` leaves the content out of every live and planned line of `{target}`, the oldest being `{oldest}`, so no output has it

**Fix:** Remove the content, which no line's output publishes, or, if a line still has it, correct the mark. A mark that makes content unavailable from a version before the oldest live line, such as `self-managed (ga 3.0, removed 3.2)` with 3.4 the oldest, leaves it in no line.

**Read more:** [`[releases.<target>]`](https://ascribed-dev.com/docs/content-model/variation.md#121-releasestarget) in the `ascribe.toml` reference.

### ASC214 `release-line-ended`

[Advice](https://ascribed-dev.com/docs/checks/diagnostics.md#severity) · [file level](https://ascribed-dev.com/docs/checks/diagnostics.md#file-level-and-page-level) · next step: [write](https://ascribed-dev.com/docs/checks/diagnostics.md#what-to-do-next) · [configurable](https://ascribed-dev.com/docs/checks/diagnostics.md#setting-a-checks-level) in `[checks]` · [SPEC §7.2](https://github.com/ascribed-dev/ascribe/blob/main/SPEC.md#72-declarations)

**When:** A live line's date in `[releases.<target>.ends]` is before the day the check runs as: today in UTC, or `ASCRIBE_TODAY`.

**Message:** support for `{target}` {line} ended on {date}, and the line is still live

**Fix:** Move the line from `live` to `archived` in `[releases.<target>]`, with its date as `ended` and, when it's still readable somewhere, its `url`; or, if its support goes on, change its date in `ends`.

**Read more:** [`[releases.<target>]`](https://ascribed-dev.com/docs/content-model/variation.md#121-releasestarget) in the `ascribe.toml` reference.

### ASC227 `memo-outdated`

[Advice](https://ascribed-dev.com/docs/checks/diagnostics.md#severity) · [file level](https://ascribed-dev.com/docs/checks/diagnostics.md#file-level-and-page-level) · next step: [write](https://ascribed-dev.com/docs/checks/diagnostics.md#what-to-do-next) · [configurable](https://ascribed-dev.com/docs/checks/diagnostics.md#setting-a-checks-level) in `[checks]` · [SPEC §7.7](https://github.com/ascribed-dev/ascribe/blob/main/SPEC.md#77-memo-files)

**When:** No block of what a [memo](https://ascribed-dev.com/docs/glossary.md#memo) file's `about` names holds its `quote`.

**Message:** no block of `{about}` has the words this memo quotes, so it's on the {place} and no block

**Fix:** The words were changed since the memo was written. Read the memo against the page as it is: if it still holds, quote the words it's about now; if it doesn't, change it or delete it. A quote is found in one block, with any run of spaces and line breaks read as one space.

**Read more:** [Placed, outdated, and detached](https://ascribed-dev.com/docs/writing/memo-files.md#placed-outdated-and-detached) in the memo files reference.

### ASC228 `memo-long`

[Advice](https://ascribed-dev.com/docs/checks/diagnostics.md#severity) · [file level](https://ascribed-dev.com/docs/checks/diagnostics.md#file-level-and-page-level) · next step: [write](https://ascribed-dev.com/docs/checks/diagnostics.md#what-to-do-next) · [configurable](https://ascribed-dev.com/docs/checks/diagnostics.md#setting-a-checks-level) in `[checks]` · [SPEC §7.7](https://github.com/ascribed-dev/ascribe/blob/main/SPEC.md#77-memo-files)

**When:** A memo file's body is longer than the limit: 2,000 characters, or `[checks.memo-long] limit`.

**Message:** this memo is {length} characters, over the {limit} limit

**Fix:** A memo is read by whoever is about to change the page, so it says why in as few words as it can. Cut what the page itself says, and split a memo about several things into one about each. The limit is 2,000 characters; set another in `ascribe.toml`, such as `[checks.memo-long] limit = 4000`.

**Read more:** [Write a memo file](https://ascribed-dev.com/docs/writing/memo-files.md#write-a-memo-file) in the memo files reference.

### ASC235 `nav-page-unplaced`

[Advice](https://ascribed-dev.com/docs/checks/diagnostics.md#severity) · [file level](https://ascribed-dev.com/docs/checks/diagnostics.md#file-level-and-page-level) · next step: [fix](https://ascribed-dev.com/docs/checks/diagnostics.md#what-to-do-next) · [configurable](https://ascribed-dev.com/docs/checks/diagnostics.md#setting-a-checks-level) in `[checks]` · [SPEC §7.8](https://github.com/ascribed-dev/ascribe/blob/main/SPEC.md#78-navigation)

**When:** `ascribe.nav` lists `pages` for a page's section and doesn't name the page. A section with no `pages` has the default order, and its pages aren't reported, nor is a section's own page, nor an `unlisted` page or a draft, which no sidebar shows.

**Message:** `{folder}`'s `pages` in ascribe.nav doesn't name this page, so it comes after the pages it does, by title

**Fix:** Add the page's file name to the section's `pages` in `ascribe.nav`, where it should come. The fix appends the section's pages that aren't named, in the order they come in now, so the navigation is the same after it; move the names to where you want them.

**Read more:** [The file](https://ascribed-dev.com/docs/navigation.md#the-file) in the navigation reference.

### ASC236 `nav-section-unplaced`

[Advice](https://ascribed-dev.com/docs/checks/diagnostics.md#severity) · [file level](https://ascribed-dev.com/docs/checks/diagnostics.md#file-level-and-page-level) · next step: [fix](https://ascribed-dev.com/docs/checks/diagnostics.md#what-to-do-next) · [configurable](https://ascribed-dev.com/docs/checks/diagnostics.md#setting-a-checks-level) in `[checks]` · [SPEC §7.8](https://github.com/ascribed-dev/ascribe/blob/main/SPEC.md#78-navigation)

**When:** `ascribe.nav` lists one or more of a section's sibling sections and not the section, which is reported on its first page. A folder none of whose sections the file lists has the default order, and isn't reported, nor is a section below the content root whose own page beside its folder places it among its parent's pages, since a table wouldn't move it.

**Message:** ascribe.nav lists other sections in `{parent}` and not `{folder}`, so it comes after them, in path order

**Fix:** Add a `[[sections]]` table with the section's `folder` to `ascribe.nav`, where the section should come. The fix appends a table for each section that isn't listed, in the order they come in now, so the navigation is the same after it; move the tables to where you want them. A file that writes `sections = [...]` inline gets no fix: add each section to its list.

**Read more:** [The file](https://ascribed-dev.com/docs/navigation.md#the-file) in the navigation reference.

### ASC243 `baseline-entry-unmatched`

[Advice](https://ascribed-dev.com/docs/checks/diagnostics.md#severity) · [file level](https://ascribed-dev.com/docs/checks/diagnostics.md#file-level-and-page-level) · next step: [outside](https://ascribed-dev.com/docs/checks/diagnostics.md#what-to-do-next) · [configurable](https://ascribed-dev.com/docs/checks/diagnostics.md#setting-a-checks-level) in `[checks]` · Ascribe's own, not in SPEC

**When:** `ascribe.baseline` has an entry that no problem of the project matches any more: the problem was fixed, or the text it was about changed. Reported at the entry's line, when `ascribe check` reads the [baseline](https://ascribed-dev.com/docs/glossary.md#baseline) and checks the whole project for every build.

**Message:** ascribe.baseline holds back `{check}` in `{file}`, and nothing there matches it any more; run `ascribe baseline prune`

**Fix:** Run `ascribe baseline prune`, which removes every entry that matches nothing, and commit ascribe.baseline. Left in the file, the entry would hold back a later problem of the same check whose text happens to be the same. See [The baseline](https://ascribed-dev.com/docs/checks/baseline.md).

**Read more:** [`[checks]`](https://ascribed-dev.com/docs/content-model/checks.md#22-checks) in the `ascribe.toml` reference.

### ASC244 `frontmatter-field-repeated`

[Advice](https://ascribed-dev.com/docs/checks/diagnostics.md#severity) · [file level](https://ascribed-dev.com/docs/checks/diagnostics.md#file-level-and-page-level) · next step: [fix](https://ascribed-dev.com/docs/checks/diagnostics.md#what-to-do-next) · [configurable](https://ascribed-dev.com/docs/checks/diagnostics.md#setting-a-checks-level) in `[checks]` · [SPEC §7.2](https://github.com/ascribed-dev/ascribe/blob/main/SPEC.md#72-declarations)

**When:** A type's own `frontmatter` declares a field exactly as `[frontmatter]` does, key for key, so the type's copy changes nothing. Reported at the type's field.

**Message:** the type `{type}` declares `{field}` exactly as `[frontmatter]` does, so this copy changes nothing; delete it, and the type has `[frontmatter]`'s

**Fix:** Delete the type's field, and the type has the one in `[frontmatter]`, which is the same. The fix deletes its line, with the comment lines directly above it, when it's written as `key = value` under the table's header; one written another way is deleted by hand. A type's field that differs from the shared one in any key replaces it whole, for that type, and isn't reported: keep it when the type needs it to differ.

**Read more:** [Page types](https://ascribed-dev.com/docs/content-model.md#41-page-types) in the `ascribe.toml` reference.

### ASC257 `addresses-base-unreadable`

[Warning](https://ascribed-dev.com/docs/checks/diagnostics.md#severity) · [file level](https://ascribed-dev.com/docs/checks/diagnostics.md#file-level-and-page-level) · next step: [outside](https://ascribed-dev.com/docs/checks/diagnostics.md#what-to-do-next) · [configurable](https://ascribed-dev.com/docs/checks/diagnostics.md#setting-a-checks-level) in `[checks]` · [SPEC §7.10](https://github.com/ascribed-dev/ascribe/blob/main/SPEC.md#710-the-addresses-file)

**When:** The project has `ascribe.addresses`, and `ascribe check` can't read the base it compares the addresses with, as in a shallow clone. Before the first commit, or outside git, with no `--base`, nothing was published, so it isn't reported; a base with no project is advice. Reported once, at `ascribe.addresses`.

**Message:** the addresses weren't compared with the base: {reason}

**Fix:** Give the check a base it can read. In CI, fetch the history (`fetch-depth: 0` on actions/checkout), and pass the branch a pull request targets, `--base origin/$GITHUB_BASE_REF`, or, on a push, the commit before it, `--base ${{ github.event.before }} --base-exact`. A base with no project, as a migration's first pull request has, published nothing, so there's nothing to compare: it's reported, as advice, so a check that compared nothing never passes silently. See [The base](https://ascribed-dev.com/docs/publishing/redirects.md#the-base).

**Read more:** [The base](https://ascribed-dev.com/docs/publishing/redirects.md#the-base) in the guide to keeping addresses.

### ASC282 `api-operation-unreferenced`

[Advice](https://ascribed-dev.com/docs/checks/diagnostics.md#severity) · [file level](https://ascribed-dev.com/docs/checks/diagnostics.md#file-level-and-page-level) · next step: [write](https://ascribed-dev.com/docs/checks/diagnostics.md#what-to-do-next) · [configurable](https://ascribed-dev.com/docs/checks/diagnostics.md#setting-a-checks-level) in `[checks]` · [SPEC §7.11](https://github.com/ascribed-dev/ascribe/blob/main/SPEC.md#711-apis)

**When:** An operation of a declared spec, not marked `deprecated`, that no link names, by its id or by its method and path.

**Message:** no page links to `{operation}` ({method} {route}) in {path}

**Fix:** Link to the operation from the guide that covers it, by its `operationId`, `openapi.yaml#getUser`, or by its method and path when it has none, `openapi.yaml#delete/users/{id}`. An operation a guide doesn't need to cover can be marked `deprecated` in the spec when it's on its way out, which leaves it out; for an API whose reference is enough on its own, turn the check off in [`[checks]`](https://ascribed-dev.com/docs/content-model/checks.md#22-checks).

**Read more:** [`[apis.<name>]`](https://ascribed-dev.com/docs/content-model/sources.md#21-apisname) in the `ascribe.toml` reference.

### ASC283 `build-filter-line-undeclared`

[Advice](https://ascribed-dev.com/docs/checks/diagnostics.md#severity) · [file level](https://ascribed-dev.com/docs/checks/diagnostics.md#file-level-and-page-level) · next step: [write](https://ascribed-dev.com/docs/checks/diagnostics.md#what-to-do-next) · [configurable](https://ascribed-dev.com/docs/checks/diagnostics.md#setting-a-checks-level) in `[checks]` · [SPEC §9.3](https://github.com/ascribed-dev/ascribe/blob/main/SPEC.md#93-build-modes)

**When:** A build's filter names a version of a target `[releases]` declares lines for, and the version is older than every line declared, so it's in no live, planned, or archived line.

**Message:** build `{build}` filters for `{target} {version}`, which is older than every line `[releases.{target}]` declares, so `ascribe versions` doesn't list it; declare its line in `archived`, or make the build one output for each live line with `versions = "{target}"`

**Fix:** Say in one place which lines the project publishes. To keep a build for an old line, declare the line in `[releases.<target>]` as archived, with no address when nothing else publishes it, as `"3.3" = {}`. To publish every live line instead, give one build `versions = "<target>"` and remove the filtered build. A version between two declared lines is `available-line-undeclared`.

**Read more:** [`[builds.<name>]`](https://ascribed-dev.com/docs/content-model/output.md#16-buildsname) in the `ascribe.toml` reference.