WORK-104
ID:WORK-104Status:done

Update authoring docs after legacy Model removal

Remove or rewrite documentation that references the legacy Model class, decorators, and createSchema. After this work, the authoring docs present createContentModelSchema as the single path.

Priority:mediumComplexity:simpleMilestone:v1.0.0Source:SPEC-032
changeset-release/main View source

Criteria completion

Criteria completion: 7 of 7 (100%) checked; tracking started on Apr 19, no incremental history yet0%25%50%75%100%Apr 19May 5

Tracking started Apr 19 — check back for trends.

Relationships

Implements 1
Related 1
Branches 2
changeset-release/main current done
main doneclaude/file-naming-convention-LJdwR done
History 5
  1. f2b3512
    Content editedby Claude
    Add {ID}-{slug}.md filename convention + migrate filenames subcommand
  2. 59ded4a
    Content editedby Claude
    Implement SPEC-037 plan package hardening: all 7 work items
  3. f262d7b
    Content editedby Claude
    Backfill source attributes on all 123 work items
  4. a20f532
    Content editedby Claude
    Mark all SPEC-032 work items as done (WORK-099 through WORK-104)
  5. 5c72bef
    Created (done)by Claude
    Add work items WORK-099 through WORK-104 for legacy Model removal

Files to update

  • site/content/docs/authoring/model-api.md — Delete entirely (full Model API reference, no longer applicable)
  • site/content/docs/authoring/overview.md — Remove references to Model class and decorator approach
  • site/content/docs/authoring/patterns.md — Rewrite patterns to use createContentModelSchema exclusively
  • site/content/docs/authoring/content-models.md — Review for any legacy cross-references
  • site/content/docs/packages/authoring.md — Ensure community package guide only references the modern API

Acceptance Criteria

  • model-api.md is deleted
  • No remaining references to Model, @attribute, @group, @groupList, @id, or createSchema in any authoring doc
  • patterns.md examples all use createContentModelSchema
  • overview.md presents createContentModelSchema as the sole schema API
  • Community package authoring guide uses only the modern pattern
  • Site builds successfully (cd site && npm run build)
  • No broken internal links (removed page references updated)

Dependencies

  • WORK-103 (legacy code removed — docs should match the actual API)

References

  • SPEC-032 (parent spec)

Resolution

Completed: 2026-04-02

Branch: claude/implement-spec-032-2KBbw

What was done

  • Deleted model-api.md (full Model API reference page)
  • Removed model-api from nav in _layout.md
  • Rewrote Hint example in authoring-overview.md to use createContentModelSchema
  • Updated checklist tables to reference createContentModelSchema instead of "Model class"
  • Rewrote patterns.md — header+body split, child item runes, and field ordering sections
  • Updated content-models.md — removed Model class cross-reference, updated base comment
  • Rewrote packages/authoring.md — game-item example uses createContentModelSchema
  • Site builds successfully (128 pages)