docs: LinksMode and Polymorphic Relationship Guide, stubs out guide for LegacyMode vs PolarisMode #9764

runspired · 2025-03-12T23:16:14Z

Rendered

guides/relationships/features/links-mode.md

Co-authored-by: Krystan HuffMenne <kmenne+github@gmail.com>

…or LegacyMode vs PolarisMode (emberjs#9764) * docs: stub out guides for SchemaRecord, LinksMode, PolarisMode etc. * add linksmode guide * fix annotation * Update guides/relationships/features/links-mode.md Co-authored-by: Krystan HuffMenne <kmenne+github@gmail.com> * Update guides/relationships/features/links-mode.md Co-authored-by: Krystan HuffMenne <kmenne+github@gmail.com> * Update guides/relationships/features/links-mode.md Co-authored-by: Krystan HuffMenne <kmenne+github@gmail.com> * Update guides/relationships/features/links-mode.md Co-authored-by: Krystan HuffMenne <kmenne+github@gmail.com> * Update guides/relationships/features/links-mode.md Co-authored-by: Krystan HuffMenne <kmenne+github@gmail.com> * Update guides/relationships/features/links-mode.md Co-authored-by: Krystan HuffMenne <kmenne+github@gmail.com> * Update guides/relationships/features/links-mode.md Co-authored-by: Krystan HuffMenne <kmenne+github@gmail.com> * Update guides/relationships/features/links-mode.md Co-authored-by: Krystan HuffMenne <kmenne+github@gmail.com> * Update guides/relationships/features/links-mode.md Co-authored-by: Krystan HuffMenne <kmenne+github@gmail.com> * Update guides/relationships/features/links-mode.md Co-authored-by: Krystan HuffMenne <kmenne+github@gmail.com> * Update guides/relationships/features/links-mode.md Co-authored-by: Krystan HuffMenne <kmenne+github@gmail.com> * Update guides/relationships/features/links-mode.md Co-authored-by: Krystan HuffMenne <kmenne+github@gmail.com> * cleanup op * rewrite future thoughts * stub out more of the guide * add docs on polymorphism * stub out guide * add note on interop * add reactivity overview --------- Co-authored-by: Krystan HuffMenne <kmenne+github@gmail.com>

chancancode · 2025-03-18T19:46:11Z

guides/relationships/features/links-mode.md

+relationships will instead provide access to a [reactive document](https://api.emberjs.com/ember-data/release/classes/Document).
+
+So for instance, if `user.homeAddress` were `async: false`, then its value would be an instance of an `Address` record.
+But if `user.homeAddress` were `asunc: true`, it would instead be a reactive class with `links`, `meta` and (only-if-loaded) `data`.


asunc (typo)

…or LegacyMode vs PolarisMode (#9764) * docs: stub out guides for SchemaRecord, LinksMode, PolarisMode etc. * add linksmode guide * fix annotation * Update guides/relationships/features/links-mode.md Co-authored-by: Krystan HuffMenne <kmenne+github@gmail.com> * Update guides/relationships/features/links-mode.md Co-authored-by: Krystan HuffMenne <kmenne+github@gmail.com> * Update guides/relationships/features/links-mode.md Co-authored-by: Krystan HuffMenne <kmenne+github@gmail.com> * Update guides/relationships/features/links-mode.md Co-authored-by: Krystan HuffMenne <kmenne+github@gmail.com> * Update guides/relationships/features/links-mode.md Co-authored-by: Krystan HuffMenne <kmenne+github@gmail.com> * Update guides/relationships/features/links-mode.md Co-authored-by: Krystan HuffMenne <kmenne+github@gmail.com> * Update guides/relationships/features/links-mode.md Co-authored-by: Krystan HuffMenne <kmenne+github@gmail.com> * Update guides/relationships/features/links-mode.md Co-authored-by: Krystan HuffMenne <kmenne+github@gmail.com> * Update guides/relationships/features/links-mode.md Co-authored-by: Krystan HuffMenne <kmenne+github@gmail.com> * Update guides/relationships/features/links-mode.md Co-authored-by: Krystan HuffMenne <kmenne+github@gmail.com> * Update guides/relationships/features/links-mode.md Co-authored-by: Krystan HuffMenne <kmenne+github@gmail.com> * Update guides/relationships/features/links-mode.md Co-authored-by: Krystan HuffMenne <kmenne+github@gmail.com> * cleanup op * rewrite future thoughts * stub out more of the guide * add docs on polymorphism * stub out guide * add note on interop * add reactivity overview --------- Co-authored-by: Krystan HuffMenne <kmenne+github@gmail.com>

* feat: schema type utils (#9757) * minor type improvements * chore: fixup types * add api docs * nice things * account for schema presence * cleanup test * chore: update contributing docs (#9758) * chore: Improve contributing experience (#9759) * chore: improve developing experience on local * more * temporarily deactivate some scenarios * deactivate more lints * deactivate more prod tests * another * chore: reduce simple Map/Set ops (#9761) * perf: faster iteration of relationship payloads (#9762) faster iteration of payloads * chore: restructure SchemaRecord test file layout to make it easier to navigate (#9763) * chore: simplify test file layout * chore: move polaris test files to new structure * docs: LinksMode and Polymorphic Relationship Guide, stubs out guide for LegacyMode vs PolarisMode (#9764) * docs: stub out guides for SchemaRecord, LinksMode, PolarisMode etc. * add linksmode guide * fix annotation * Update guides/relationships/features/links-mode.md Co-authored-by: Krystan HuffMenne <kmenne+github@gmail.com> * Update guides/relationships/features/links-mode.md Co-authored-by: Krystan HuffMenne <kmenne+github@gmail.com> * Update guides/relationships/features/links-mode.md Co-authored-by: Krystan HuffMenne <kmenne+github@gmail.com> * Update guides/relationships/features/links-mode.md Co-authored-by: Krystan HuffMenne <kmenne+github@gmail.com> * Update guides/relationships/features/links-mode.md Co-authored-by: Krystan HuffMenne <kmenne+github@gmail.com> * Update guides/relationships/features/links-mode.md Co-authored-by: Krystan HuffMenne <kmenne+github@gmail.com> * Update guides/relationships/features/links-mode.md Co-authored-by: Krystan HuffMenne <kmenne+github@gmail.com> * Update guides/relationships/features/links-mode.md Co-authored-by: Krystan HuffMenne <kmenne+github@gmail.com> * Update guides/relationships/features/links-mode.md Co-authored-by: Krystan HuffMenne <kmenne+github@gmail.com> * Update guides/relationships/features/links-mode.md Co-authored-by: Krystan HuffMenne <kmenne+github@gmail.com> * Update guides/relationships/features/links-mode.md Co-authored-by: Krystan HuffMenne <kmenne+github@gmail.com> * Update guides/relationships/features/links-mode.md Co-authored-by: Krystan HuffMenne <kmenne+github@gmail.com> * cleanup op * rewrite future thoughts * stub out more of the guide * add docs on polymorphism * stub out guide * add note on interop * add reactivity overview --------- Co-authored-by: Krystan HuffMenne <kmenne+github@gmail.com> * feat: improve debuggability of SchemaRecord, RecordArray and Identifier (#9766) * feat: improve debuggability of SchemaRecord, RecordArray and Identifier * fix configurability * fix keys * feat: persist runtime config (#9767) * feat: persist runtime config * ensure fastboot works * Don't set isDirty to true in diff callbacks (#9765) * More overnotification fixes * Fix DEPRECATE_RELATIONSHIP_REMOTE_UPDATE_CLEARING_LOCAL_STATE case * feat: ensure objects behave amazeballs (#9768) * feat: ensure objects behave amazeballs * add tests for record iteration * add more tests * fix(deps): update dependency @babel/runtime to v7.26.10 [security] (#9760) Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com> * chore: remove restriction on new field kinds being used with legacy mode * improve types * Revert "improve types" This reverts commit 84daef7. * Revert "chore: remove restriction on new field kinds being used with legacy mode" This reverts commit 3fd81bf. * Widen Peer Range for ember-inflector (#9770) * chore: remove restriction on new field kinds being used with legacy mode (#9769) * chore: remove restriction on new field kinds being used with legacy mode * chore: cleanup types * fix * fix test * fix docs * chore: cleanup @ember/service deprecation from shipped library code (#9773) * Add: tests verify behavior mutating a record (#9754) * add: tests verify behavior mutating a related record from a checked-out record * fix: lint * fix: test * fix: lint * fix: better reordering detection when remoteClearsLocal is true (#9771) * Fix DEPRECATE_RELATIONSHIP_REMOTE_UPDATE_CLEARING_LOCAL_STATE reordering detection * add failing test * notification tests * implement fix * cleanup console logs * fix spurrious type issue --------- Co-authored-by: Chris Thoburn <runspired@users.noreply.github.com> * Fix some lint --------- Co-authored-by: Chris Thoburn <runspired@users.noreply.github.com> Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com> Co-authored-by: Jon Johnson <jon.johnson@ucsf.edu> Co-authored-by: Mehul Kiran Chaudhari <55375534+MehulKChaudhari@users.noreply.github.com>

docs: stub out guides for SchemaRecord, LinksMode, PolarisMode etc.

cbefaed

runspired added 🎯 canary PR is targeting canary (default) 🏷️ doc This PR adds/improves/or fixes documentation labels Mar 12, 2025

runspired added 2 commits March 12, 2025 18:09

add linksmode guide

58a3afd

fix annotation

59d027b