C++ GA Docs Updates

[dacharyc]

Pull Request Info

DO NOT MERGE until C++ GA release.

These PRs have already been individually reviewed and approved. This is a consolidated branch with all the changes for the C++ GA. Any review is just a check for anything that might have slipped through the prior reviews.

• C++ GA Staged Site: See release notes section below for summary of changes.

Release Notes

• C++ SDK
  • Update docs throughout SDK for C++ GA release, including:
    • Remove "Preview" from naming.
    • Move Bluehawked, tested code examples out of the experimental namespace, and generate updated examples.
    • Remove tabs for "Current" and "Deprecated" (Beta and Alpha) syntaxes.
    • Remove .. versionadded:: and .. versionchanged:: directives to reset for GA release.
    • Update API reference links.
    • Update the Google authentication examples for updated naming in v0.6.0-preview.
    • Add new documentation and Bluehawked code examples for new functionality in GA:
      • Quick Start: New section about closing a realm.
      • Realm Files
        • Configure & Open a Realm: New section about closing a realm.
        • Reduce Realm File Size: New page about compacting a realm.
      • Application Services/Call a Function: Update the example to remove BSON and use the new string-based API.
      • Manage Users
        • Authenticate Users: Update the Custom Function User example to remove BSON and use the new string-based API.
        • Custom User Data: Update examples that show calling a Function to create, update, and delete user data to remove BSON and use the new string-based API.
      • Sync Device Data/Handle Sync Errors: New "Client Reset" section with info and code examples for client resets.

Review Guidelines

REVIEWING.md

[github-actions]

Readability for Commit Hash: ed21f73

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

Readability scores for changed documents:

• source/sdk/cpp: Grade Level: 10.2, Reading Ease: 42.78
• source/sdk/cpp/application-services: Grade Level: 8.5, Reading Ease: 57.98
• source/sdk/cpp/realm-files: Grade Level: 6.9, Reading Ease: 56.62
• source/sdk/cpp/telemetry: Grade Level: 0.9, Reading Ease: 93.81
• source/sdk/cpp/install: Grade Level: 7.3, Reading Ease: 61.12
• source/sdk/cpp/quick-start: Grade Level: 7.0, Reading Ease: 67.25
• source/sdk/cpp/manage-users: Grade Level: 8.3, Reading Ease: 58.38
• source/sdk/cpp/logging: Grade Level: 7.7, Reading Ease: 65.42
• source/sdk/cpp/react-to-changes: Grade Level: 10.8, Reading Ease: 41.16
• source/sdk/cpp/sync: Grade Level: 9.9, Reading Ease: 48.81
• source/sdk/cpp/sync/log-level: Grade Level: 7.4, Reading Ease: 66.13
• source/sdk/cpp/sync/sync-subscriptions: Grade Level: 7.1, Reading Ease: 66.94
• source/sdk/cpp/sync/write-to-synced-realm: Grade Level: 10.0, Reading Ease: 53.92
• source/sdk/cpp/sync/handle-sync-errors: Grade Level: 9.1, Reading Ease: 56.25
• source/sdk/cpp/sync/stream-data-to-atlas: Grade Level: 9.7, Reading Ease: 54.83
• source/sdk/cpp/sync/manage-sync-session: Grade Level: 6.2, Reading Ease: 69.28
• source/sdk/cpp/users/authenticate-users: Grade Level: 8.0, Reading Ease: 59.09
• source/sdk/cpp/users/custom-user-data: Grade Level: 10.6, Reading Ease: 52.39
• source/sdk/cpp/users/manage-email-password-users: Grade Level: 9.0, Reading Ease: 51.14
• source/sdk/cpp/app-services/connect-to-app: Grade Level: 7.5, Reading Ease: 60.61
• source/sdk/cpp/app-services/call-a-function: Grade Level: 8.7, Reading Ease: 62.88
• source/sdk/cpp/model-data/object-models: Grade Level: 9.0, Reading Ease: 56.66
• source/sdk/cpp/model-data/relationships: Grade Level: 9.4, Reading Ease: 50.23
• source/sdk/cpp/model-data/supported-types: Grade Level: 9.9, Reading Ease: 49.01
• source/sdk/cpp/crud/update: Grade Level: 11.6, Reading Ease: 33.71
• source/sdk/cpp/crud/filter-data: Grade Level: 8.8, Reading Ease: 57.06
• source/sdk/cpp/crud/read: Grade Level: 8.8, Reading Ease: 57.06
• source/sdk/cpp/crud/delete: Grade Level: 6.6, Reading Ease: 62.75
• source/sdk/cpp/crud/create: Grade Level: 9.5, Reading Ease: 50.02
• source/sdk/cpp/crud/threading: Grade Level: 7.8, Reading Ease: 65.12
• source/sdk/cpp/realm-files/encrypt-a-realm: Grade Level: 8.0, Reading Ease: 64.61
• source/sdk/cpp/realm-files/compact-realm: Grade Level: 6.7, Reading Ease: 68.06
• source/sdk/cpp/realm-files/configure-and-open-a-realm: Grade Level: 7.2, Reading Ease: 66.64
• source/sdk/swift/sync/handle-sync-errors: Grade Level: 9.5, Reading Ease: 50.02

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.

[cbullinger]

Branch looks solid 💪 A few minor, non-blocking gravy suggestions, but overall, LGTM! Nice work!

[cbullinger]

[microscopic nit]

Suggested change

	echo "Bluehawking C++ sync SDK examples"
	echo "Bluehawking C++ sync examples"

[cbullinger]

[suggestion] out of scope for this, but maybe add a similar note/warning (re. C++ SDK not yet supporting the full range of RQL expressions) to the Sync Data landing page's Flexible Sync section

[cbullinger]

[suggestion] out of scope, but maybe update the realm-files.txt container page with a TOC list. it currently is the only blank container page if you navigate to it

[docs-builder-bot]

✨ Staging URL: https://preview-mongodbmongodb.gatsbyjs.io/realm/master/

🪵 Logs

• job log: 7b7fd52a80cbc490a950d3c51a1475203537af5b