Skip to content

docs: give maintained models their own page - #1593

Merged
kvlonge merged 1 commit into
mainfrom
docs/maintained-models-page
Nov 19, 2026
Merged

kvlonge merged 1 commit into
mainfrom
docs/maintained-models-page

Conversation

@kvlonge

@kvlonge kvlonge commented Nov 19, 2026

Copy link
Copy Markdown
Contributor

Why

The Maintained section had grown to take over the materializations page, and it was the only materialization with an error-code table.

Changes

  • New page concepts/models/maintained.mdx ("Maintained Models"), in the sidebar after Snapshots: settings, what the plan shows, during a build (short bullets), and when a build dies (one build at a time, the next build resumes after heartbeat_grace, --ignore-maintained-grace where allowed).
  • The lock's tie-break explanation is gone.
  • materializations.mdx keeps a Maintained section the size of View and Table (one sentence, the example, a link) and its row under "When a build fails".
  • No error-code table. A718 is named under "one build at a time" and A719 next to the flag; compile errors print their own help.
  • Limitations: dropped the custom-materialization line; the snapshot change-tracking and default refresh_mode lines are one short line each.
  • Repointed links to the old anchors from cli/build, project-configuration and the Snowflake page.
  • Regenerated the packaged skill's docs references.

Verification

  • scripts.check_docs_skill: references up to date.
  • Checked by hand that each new link's anchor exists.
  • The website build and link check run in CI.

Move maintained models from the materializations page to their own page next to
Incremental and Snapshots: settings, what the plan shows, what a build does, and
what happens when a build dies. The materializations page keeps a short section
like View and Table. Drop the error-code table; A718 and A719 are named where
their situations are explained. Repoint links to the old anchors.
@kvlonge
kvlonge enabled auto-merge November 19, 2026 07:03
@kvlonge
kvlonge added this pull request to the merge queue Nov 19, 2026
Merged via the queue into main with commit 8fbfce8 Nov 19, 2026
32 checks passed
@kvlonge
kvlonge deleted the docs/maintained-models-page branch November 19, 2026 07:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant