[detail-app]

Section 9 of MIGRATION.md said sentinel and Firestore type schemas carry jsonSchema annotations, but the underlying implementation was replaced with representation + toCodecJson links. The term jsonSchema no longer matches any option name in the code, so the migration guide contradicted the updated AGENTS.md JSON Schema section and would mislead anyone upgrading from v0.x into using a non-existent annotation.

Introduced by commit 2c6dc8a (@fwal, #134)

---

Doc Drift PRs can be configured here.

[greptile-apps]

Confidence Score: 5/5

The PR appears safe to merge.

What we checked:

• Migration guide names the right hook: Yes. The schemas use a toCodecJson hook, and the package guide uses the same name.

Summary

The migration guide now names the JSON codec hook as toCodecJson instead of the outdated jsonSchema option. This keeps the upgrade instructions aligned with the current Firestore schema code.

Diagram

sequenceDiagram
    participant D as Developer
    participant M as MIGRATION.md
    participant S as Firestore schema
    participant J as JSON codec
    D->>M: Read the v1 migration guide
    M-->>D: Name the `toCodecJson` annotation
    D->>S: "Use a model's `json*` variant"
    S->>J: Follow the `toCodecJson` link
    J-->>D: Produce JSON-safe data and schema

Loading

_{Reviews (1) · Last reviewed commit: "docs: correct MIGRATION jsonSchema -> to..."}