Skip to content

docs: complete the v2 migration guide and changesets - #368

Open
eli-r-ph wants to merge 7 commits into
v1-session-id-liftfrom
v1-migration-guide-fixes
Open

eli-r-ph wants to merge 7 commits into
v1-session-id-liftfrom
v1-migration-guide-fixes

Conversation

@eli-r-ph

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

Copy link
Copy Markdown
Contributor

💡 Motivation and Context

Stacked on #367.

Makes the v2 migration guide, changesets and godoc match what v2 does.
No behavior changes.

Changes

  • Config: documents MaxBatchBytes, the optional MaxEventBytes, MaxRetryBackoff, and values Validate rejects.
  • Request context: documents opt-in tracing headers and how context applies to identity calls.
  • Group identify: documents that GroupIdentify.DistinctId is now sent.
  • Errors: documents CaptureLocalError and the log line used without a Callback.
  • Retries: documents which errors retry and how Retry-After is capped.
  • Event IDs: documents UUIDv7 and how caller IDs are checked.
  • Properties and AI events: fixes flag-property order and EnqueueAI details.
  • Fixes stale changesets and godoc.
  • Moves otel/package.json to 1.34.0 to match the latest otel tag.

💚 How did you test it?

  • gofmt, go vet, go test -race and make api-diff pass; the API snapshot is unchanged.

🤖 Agent context

Autonomy: Human-driven (agent-assisted). Written with Claude Code; each claim was checked against the code.

🤖 Generated with Claude Code

@eli-r-ph eli-r-ph self-assigned this Oct 10, 2026
@eli-r-ph
eli-r-ph marked this pull request as ready for review October 10, 2026 04:03
@eli-r-ph
eli-r-ph requested a review from a team as a code owner October 10, 2026 04:03
@eli-r-ph
eli-r-ph force-pushed the v1-migration-guide-fixes branch from 5620573 to a3a635f Compare October 10, 2026 20:35
@eli-r-ph
eli-r-ph force-pushed the v1-migration-guide-fixes branch from a3a635f to f28ef50 Compare October 11, 2026 20:03
@eli-r-ph
eli-r-ph force-pushed the v1-migration-guide-fixes branch from f28ef50 to bf97773 Compare October 13, 2026 05:10
@eli-r-ph eli-r-ph changed the title docs: complete the v2 migration guide, changesets and godoc docs: complete the v2 migration guide and changesets Oct 13, 2026
@eli-r-ph
eli-r-ph force-pushed the v1-migration-guide-fixes branch from bf97773 to 204a08c Compare October 18, 2026 17:52

@dustinbyrne dustinbyrne left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The migration guide and changeset corrections match the implementation at this stack tip. Two optional wording clarifications below; neither prevents approval.

AI-assisted review.

Comment thread docs/migration-v2.md Outdated
Comment thread docs/migration-v2.md Outdated
@eli-r-ph
eli-r-ph force-pushed the v1-migration-guide-fixes branch from 204a08c to 5590635 Compare October 20, 2026 15:58

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.

2 participants