Update docs and migration guide for the catalog API updates

[abey79]

Related

• part of https://linear.app/rerun/issue/RR-2901/pr-tracking-clean-up-cloud-apis-project

What

• Cleanup migration guide
• Fix existing docs
• Sneak a deprecation in the viewer event stuff

[github-actions]

Latest documentation preview deployed successfully.

Result	Commit	Link
✅	18e28ad	https://landing-bu380pssh-rerun.vercel.app/docs

^{Note: This comment is updated whenever you push a commit.}

[Copilot]

Pull request overview

This PR updates documentation and the migration guide to reflect recent catalog API changes, primarily the renaming of "partition" terminology to "segment" and a comprehensive overhaul of the catalog module APIs. The changes consolidate the migration guide into a more structured format and update code examples to use the new API patterns.

• Consolidated catalog API migration guide with clearer categorization
• Updated documentation examples to use new method names (get_dataset(), datasets(), etc.)
• Added deprecation decorator for partition_id property in viewer events

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.

File	Description
rerun_py/rerun_sdk/rerun/event.py	Adds deprecated partition_id property to maintain backward compatibility while transitioning to segment_id
docs/content/reference/migration/migration-0-28.md	Major restructuring of migration guide with consolidated sections for catalog API changes, clearer categorization, and updated code examples
docs/content/getting-started/data-out/query-data.md	Updates code examples to use new API methods and patterns (e.g., get_dataset(), datasets(), DatasetView)

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Corrected 'now abstracted' to 'are now abstracted' for grammatical correctness.

Suggested change

	The updated APIs now abstracted from the underlying storage mechanism (blueprint datasets).
	The updated APIs are now abstracted from the underlying storage mechanism (blueprint datasets).

[ntjohnson1]

LGTM. Added copilot review in case there was a typo or something. Looks pretty clear.