Skip to content

docs: Extract Model reference and reshape Models concept pages#674

Open
developerjamiu wants to merge 4 commits into
mainfrom
concepts-phase2-pr3a-models
Open

docs: Extract Model reference and reshape Models concept pages#674
developerjamiu wants to merge 4 commits into
mainfrom
concepts-phase2-pr3a-models

Conversation

@developerjamiu

@developerjamiu developerjamiu commented Jul 6, 2026

Copy link
Copy Markdown
Contributor

Phase 2 IA, PR 3a of 7 (tracked in #671): reshapes the Models subgroup and extracts a Model reference. This is the first half of the Data & the database work; the Database subgroup follows in PR 3b.

What changed

  • Model reference (new): the master model-keyword table moves out of Working with models into a dedicated reference. All 31 keyword rows are preserved, and every link is rebased. This becomes the single source that PR 3b's Database tables page defers to.
  • Working with models: the keyword table is replaced with a pointer to the Model reference; added a description. All explanatory content and the per-type default tables stay on the page.
  • Vector & geography fields: the two twin pages are merged into one, preserving both intros, all field types, and the warnings. The old pages are deleted and inbound links updated (the type anchors are unchanged).
  • Custom serialization: added frontmatter; fixed a stray import (relation_test_shared to my_project_shared), an incomplete code sample, and a fluff word.
  • Inheritance & polymorphism and Backward compatibility: cross-linked to each other; conformance.
  • Shared packages: refreshed the version pins to the current 4.0-beta line (Dart ^3.10.3, Serverpod 4.0.0-beta.0).

Notes

  • Version values track the current dev line (4.0-beta on main); the Dart SDK ^3.10.3 matches the framework template.
  • Structural changes (grouping pages into a sidebar category, the section rename, redirects) are deferred to the final PR of this series, so this PR keeps every page at its current URL.
  • The serverpod generate references on these pages are accurate (the command still exists); their framing is modernized separately in Update references to 'serverpod generate' to reflect the changes with hot reload #538, a dedicated cross-cutting pass so every page stays consistent.

@developerjamiu developerjamiu self-assigned this Jul 6, 2026
@developerjamiu developerjamiu added documentation Improvements or additions to documentation enhancement New feature or request labels Jul 6, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant