Skip to content

docs(migration): Trim v11 migration guide for the first alpha - #23140

Merged
nicohrubec merged 11 commits into
developfrom
docs/trim-migration-guide-v11-alpha
Aug 7, 2026
Merged

docs(migration): Trim v11 migration guide for the first alpha#23140
nicohrubec merged 11 commits into
developfrom
docs/trim-migration-guide-v11-alpha

Conversation

@nicohrubec

@nicohrubec nicohrubec commented Aug 7, 2026

Copy link
Copy Markdown
Member

Updating the migration guide for the first v11 alpha. The previous state is copied to docs/migration/v11-end-state.md, so we can reuse the sections from there as we implement more breaking changes.

nicohrubec and others added 6 commits August 7, 2026 11:08
Copy the full aspirational guide to docs/migration/v11-end-state.md and trim
MIGRATION.md down to what actually ships in the alpha (removing not-yet-implemented
items and internal TODO(v11) notes).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…ction

Missing comma after the `ignoreSpans` array made the `beforeSendSpan` "after"
snippet invalid JS.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Cross-checked the guide against the Linear v11 project's "alpha" and "second
alpha" milestones. Removed migration entries whose tickets are still open and
which the code confirms are not yet implemented: `network.*` attribute
alignment, AMQP/Redis legacy-attribute removal, `OpenTelemetryServerRuntimeOptions`
removal, `semanticAttributes` re-export removal, `SentrySpanArguments` cleanup,
`BrowserOptions` transport generic, and unified attribute typing/serialization.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Sync the aspirational reference with the latest develop MIGRATION.md so it
includes the span op breaking-changes section from #23137.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
The InvokeModel path sets `gen_ai.generate_content`, not `gen_ai.invoke_model`
(bedrock-runtime.ts:246). Correct the "After" op in the span-op changes table.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@nicohrubec
nicohrubec marked this pull request as ready for review August 7, 2026 10:02
Comment thread MIGRATION.md
nicohrubec and others added 3 commits August 7, 2026 15:27
…n-guide-v11-alpha

# Conflicts:
#	MIGRATION.md
Merge develop's restructured "Better OpenTelemetry interoperability" section
(three named setups, from #23149), remove the trailing TODO(v11) OpenTelemetry
guide link for the user-facing alpha, and refresh the end-state copy.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Comment thread docs/migration/v11-end-state.md Outdated
Comment thread docs/migration/v11-end-state.md
nicohrubec and others added 2 commits August 7, 2026 16:05
…py too

The end-state doc is canonical and the alpha guide is that doc minus the
not-yet-implemented removals, so correctness fixes must live in both. Port the
AWS Bedrock InvokeModel op (`gen_ai.generate_content`) and the `ignoreSpans`
example comma fix into docs/migration/v11-end-state.md.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Comment thread docs/migration/v11-end-state.md
@nicohrubec
nicohrubec merged commit f3c0b89 into develop Aug 7, 2026
38 checks passed
@nicohrubec
nicohrubec deleted the docs/trim-migration-guide-v11-alpha branch August 7, 2026 14:16
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.

4 participants