(DOCSP-39503): Consolidate Relationships page

[dacharyc]

Pull Request Info - SDK Docs Consolidation

Jira ticket: https://jira.mongodb.org/browse/DOCSP-39503

Staged Page

• Relationships

Page Source

Add links to every SDK's pages where you got the SDK-specific information:

• C++: Relationships
• Flutter: Relationships
• Java: Relationships
• Kotlin: Relationships
• .NET: Relationships
• Node.js: Relationships and Embedded Objects
• Swift: Relationships

PR Author Checklist

Before requesting a review for your PR, please check these items:

• [x] Open the PR against the feature-consolidated-sdk-docs branch instead of master
• [x] Tag the consolidated page for:
  • genre
  • meta.keywords
  • meta.description

Naming

• [x] Update Realm naming and the language around persistence layer/local/device per this document
• [x] Include .rst files comply with the naming guidelines

Links and Refs

• [x] Create new consolidated SDK ref targets starting with "_sdks-" for relevant sections
• [x] Remove or update any SDK-specific refs to use the new consolidated SDK ref targets
• [x] Update any Kotlin API links to use the new Kotlin SDK roles

Content

• [x] Shared code boxes have snippets or placeholders for all 9 languages
• [x] API description sections have API details or a generic placeholder for all 9 languages
• [x] Check related pages for relevant content to include
• [x] Create a ticket for missing examples in each relevant SDK: Consolidation Gaps epic

Reviewer Checklist

As a reviewer, please check these items:

• [x] Shared code example boxes contain language-specific snippets or placeholders for every language
• [x] API reference details contain working API reference links or generic content
• [x] Realm naming/language has been updated
• [x] All relevant content from individual SDK pages is present on the consolidated page

[github-actions[bot]]

Readability for Commit Hash: a9d25d60eab9aa973d59f17c142ea76c5c66c34e

You can see any previous Readability scores (if they exist) by looking at the comment's history.

Readability scores for changed documents:

• source/sdk/model-data/relationships: Grade Level: 11.1, Reading Ease: 45.66

For Grade Level, aim for 8 or below.

For Reading Ease scores, aim for 60 or above:

Score	Difficulty
90-100	Very Easy
80-89	Easy
70-79	Fairly Easy
60-69	Medium
50-59	Fairly Hard
30-49	Hard
0-29	Very Hard

For help improving readability, try Hemingway App.

[dacharyc]

LGTM! Only lingering question is that the Kotlin page includes how to make the different types of relationship for embedded objects. Is this specific to Kotlin and will this information be included in the embedded object section for Kotlin? @dacharyc Link to Kotlin page: https://www.mongodb.com/docs/atlas/device-sdks/sdk/kotlin/realm-database/schemas/relationships/#define-an-embedded-object

Totally reasonable question, @lindseymoore ! In the consolidated docs set, the Embedded Object info is on the "Define an Object Model" page - you can see the details in this PR: https://github.com/mongodb/docs-realm/pull/3314

Here's the section about Embedded Objects: https://preview-mongodbdacharyc.gatsbyjs.io/realm/DOCSP-39502/sdk/model-data/object-models/#define-an-embedded-object

I removed the info from here because embedded objects aren't related objects in the same way as the other relationships here. They can't exist independent of their parent object. The relationships described here are about linking two object types that each have independent lifecycles. The concept info here does mention embedded objects and link out to the other page, but obviously the page content isn't populated here - it's in the PR for the consolidated "Define an Object Model" page.

[docs-builder-bot]

✨ Staging URL: https://preview-mongodbmongodb.gatsbyjs.io/realm/feature-consolidated-sdk-docs/

🪵 Logs

• job log: 81be17cca4da0f4670b4ccc17c3a0f9617a2c0e8