docs: bring the prose in line with what the Python and Rust SDKs do on main

[JosteinGj]

An audit of every reference page and guide against dataplatform-rust-sdk main (ef6336b), and the api where a claim is server-side.

The examples were already right: every Python name and keyword argument the docs use exists in the built SDK (671 calls checked against inspect.signature), and all 161 Java and Rust examples compile. What had drifted was the prose.

What changed

• Default page size: Python and Rust return up to 1000 rows when no limit is set, not 100 (events, filters, subscriptions).
• Subscriptions: the filter sends every criterion and the cursor; the documented Python signature is replaced with the real one.
• Typed update echo: resource, asset and function updates echo typed nodes in Python and Rust, not flat Resources.
• Coverage: Python and Rust have the assets service; neither has a relation update form or a policy service; events.list() is documented (oldest first, no cursor).
• Stale behaviour:
  • subType/status sorts page.
  • Sort order is compared case-insensitively, and the first recognised property wins.
  • Cursors carry no version tag; the example cursors are re-encoded.
  • The 64-character source limit on event update is gone.
  • id is an exact criterion, not a pattern.
  • 408 is spooled.
  • The buffered ingest path sends one request at a time.
  • Every refusal is a typed problem document.
• Files: the trash keeps external ids and records deletedAt (deleted_at in Python and Rust). An upload's external id defaults to the file name, verbatim (SDK 811b093).
• Async client: AsyncDataHubClient lacks only the binary ingest calls.
• Guides:
  • fetch_related walks edges in both directions, so the correlate-alarms intersection includes both pumps.
  • Re-raising an event with the same external id stores a second event.
  • An MCP time-series delete purges its datapoints, and deleting a data set that still has members fails.

Left out on purpose

• The units guide and the MCP timeseries_create row: docs(units): a create may name its unit by unitExternalId alone #105 changes those.
• New examples: no fences were added or removed, so no plan block counts change. Still missing:
  • Python and Rust examples for the latest datapoint, time-series search and assets;
  • functions.by_external_id.

Checks

• Structure, API-surface and coverage tiers: 336 passed.
• Compile tier: 161 passed (Java and Rust).
• Live Python tier against a local stack: 285 passed and 35 failed. All 35 fail identically on unmodified master; they are being investigated separately.

🤖 Generated with Claude Code