Skip to content

docs: finish the 1.0 migration guide and changesets - #280

Open
eli-r-ph wants to merge 3 commits into
v1from
v1-sdk-identity-docs
Open

eli-r-ph wants to merge 3 commits into
v1from
v1-sdk-identity-docs

Conversation

@eli-r-ph

@eli-r-ph eli-r-ph commented Oct 8, 2026 •

Copy link
Copy Markdown
Contributor

💡 Motivation and Context

The 1.0 migration guide and changesets missed several changes already on v1. This PR fills the gaps. No runtime code changes.

Changes

  • New migration-guide sections: SDK identity ($lib comes from the request header) and event IDs.
  • The guide now covers non-exhaustive types, the new Endpoint::CaptureAi variant, the C compiler zstd needs, retried statuses, the default drop log, and $debug_images.
  • The AI section says the immediate AI methods also drop events over 8 MiB locally, which fix: immediate AI size check and new retry defaults #286 ships.
  • New changesets for the AI lane, TLS features, SDK identity and non-exhaustive types.
  • Crate docs gain "AI events" and "Cargo features" sections.
  • Test fixtures use real per-event drop reasons; billing_limit_exceeded is a whole-request 402, never a per-event result.
  • Small fixes: the 0.x version in the TOML example, api_key takes a String, and a stale note in examples/README.md.

Land with #286, since the AI text describes its change.

💚 How did you test it?

  • Each claim was checked against the v1 source.
  • fmt, clippy and tests pass, including the new lib.rs example.

🤖 Generated with Claude Code

@eli-r-ph
eli-r-ph requested a review from a team as a code owner October 8, 2026 00:09
@eli-r-ph eli-r-ph self-assigned this Oct 8, 2026
Covers the event ID rules, the $lib strip and the removed $lib_version
parts, AI lane size limits, the C compiler need, retryable statuses and
the no-hook log line, newly non-exhaustive types, and $debug_images.
Adds changesets for capture_ai, the TLS features, the non-exhaustive
types and the SDK identity header, and uses real per-event quota tags in
test fixtures.
@eli-r-ph
eli-r-ph force-pushed the v1-sdk-identity-docs branch from 554e239 to aeaf188 Compare October 12, 2026 17:34
@eli-r-ph eli-r-ph changed the title docs: explain that the sdk-info header sets $lib on 1.0 docs: finish the 1.0 migration guide and changesets Oct 13, 2026

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant