Skip to content

Docs: schema management options and the command line, linked to Weasel and the stateful resource model - #525

Merged
jeremydmiller merged 1 commit into
mainfrom
docs/schema-management-links
Nov 7, 2026
Merged

jeremydmiller merged 1 commit into
mainfrom
docs/schema-management-links

Conversation

@jeremydmiller

Copy link
Copy Markdown
Member

What

Documentation only. Fisher's docs already said db-apply and resources setup migrate under AutoCreate.None, but never said how to enable those commands or what the rest of them do. This links every mention to the Weasel reference and the JasperFx stateful resource model, and lays out the options.

  • docs/schema/index.md: Weasel link to the docs site; a table of the four approaches (lazy, startup, deployment step, reviewed SQL) with db-assert as the gate; a new From the command line section: RunJasperFxCommands(args), the five db-* commands and resources list/check/setup, which are Weasel's and which JasperFx's, that the explicit applies migrate under None, and that db-apply against a path that does not exist yet creates the file. The None tip links the commands.
  • docs/schema/migrations.md: Production migrations now names db-dump / db-patch as the command-line forms and the db-apply / resources setup deployment-step alternative; db-patch linked where WriteMigrationFileAsync is described.
  • docs/configuration/storeoptions.md, docs/schema/exporting.md, docs/getting-started.md: link the commands and the options.

Checked

  • vitepress build docs passes (no dead internal links); all external links checked live.
  • Part of a sweep across Marten, Polecat, Fisher, Wolverine, CritterWatch and Weasel itself (the Weasel docs PR adds a canonical "Choosing a Schema Management Approach" page these pages can link to once redeployed).

🤖 Generated with Claude Code

…easel and the stateful resource model

Database Management opens with the four approaches (lazy AutoCreate, startup via
ApplyAllDatabaseChangesOnStartup / AddResourceSetupOnStartup, db-apply or resources setup as a
deployment step, db-patch / db-dump scripts, db-assert as the gate) and gains a "From the command
line" section: how RunJasperFxCommands enables the db-* commands and resources, what each does, and
that a db-apply against a path that does not exist yet creates the file. The Weasel link goes to the
docs site. Every db-* and resources mention on the migrations, store options, exporting and getting
started pages links to its reference.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@jeremydmiller
jeremydmiller merged commit cd27f9c into main Nov 7, 2026
3 checks passed
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