correct six API errors the snippet compiler found
Building every code block turned up mistakes that reading could not:
- ISchemaBuilder has CreateCollection and CreateIndex - there is no AlterCollection,
so the migration example was written against an API that does not exist
- IMigration requires six members (Version, Name, Description, CreatedAt, Up, Down),
not the two the example showed
- IndexedField takes a required index name
- set-membership filters need List<T>, not an array: on .NET 9+ array.Contains binds
to MemoryExtensions.Contains(ReadOnlySpan<T>, T) and a ref struct cannot appear in
an expression tree, so the filter does not compile
- AbstractModel.Guid is nullable, so the list element type is Guid? too
- the Security page used one name for both the JWT provider and the secret provider
Adds the verify:context and verify:skip markers the CI job reads. Both are HTML
comments, so neither renders. Context exists because most blocks are fragments by
design - they use store and product because the prose just introduced them, and a
guide should not have to be written for the compiler. Four blocks are skipped, each
with a stated reason: they reference types the reader writes.
birko
committed
Sep 18, 2026
the eight remaining area pages
Core Concepts, Data and Stores, SQL Databases, Communication, AI and LLM,
Workflow and Background Jobs, Security, Web UI, Desktop XAML.
Written to guide rather than catalogue: each page opens with what you would do,
not with how many projects exist. Code was run before being written down - the
store, ordering, serialization, workflow and job examples all come from a harness
that executes them against the current framework.
Carries the traps forward as warnings where a reader will hit them rather than
burying them: PrecisionField without ScaleField truncating money, plain DateTime
being a wall clock, the schema being created but never altered, bulk Read(filter)
returning a collection, all-rows writes being refused, tenant wrappers failing
open, and the generated token files being outputs.
birko
committed
Sep 18, 2026