docs: schema 2.1 guide, codes, changelog, and report
A guide page for the four registries: where entries live, how targets point at them, the other new fields, the brace-reference table, what students never see, the lecture and glossary pages, every new error and lint rule, and the migration from terms.yaml and values.yaml. The setup guide points at it. The README covers glossary.yaml, the nine schemas, the 2.1 checks, the glossary lint family and the note severity, the new lecture commands and report sections, migrate glossary, and schema version 2.1. Module docs and the changelog follow. docs/design/2.1/CODES.md maps the specification's E, W, and I codes to coursebank's messages and lint codes, each with its test, and REPORT.md records what changed, the two remaining schema differences, every choice made where the specification left room, and suggested changes to it. A new test covers the validation messages the specification does not number. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
11 files changed
+535
-29
No files matched your search
+2
-2
@@ -7,8 +7,8 @@
|
||||
//! The three modules here are what you interact with before an exam exists, and
|
||||
//! they divide by how much authority each one has.
|
||||
//!
|
||||
//! [`lint`] has none. Its 26 rules are advice with stable codes, every one
|
||||
//! silenceable with `--ignore`. It is deliberately separate from the validation in
|
||||
//! [`lint`] has none. Its 44 rules are advice with stable codes, every one
|
||||
//! silenceable with `--ignore`, and the two that report notes never fail. It is deliberately separate from the validation in
|
||||
//! [`crate::model::bank`], which enforces what must be true and fails. Conflating
|
||||
//! the two produces a tool that either blocks you on style or lets real errors
|
||||
//! through.
|
||||
|
||||
Reference in new issue
Block a user