Skip to content

docs: add SDK 3 upgrade summaries - #298

Open
zhongkechen wants to merge 3 commits into
mainfrom
docs/sdk-3-upgrade-guides
Open

zhongkechen wants to merge 3 commits into
mainfrom
docs/sdk-3-upgrade-guides

Conversation

@zhongkechen

@zhongkechen zhongkechen commented Oct 22, 2026 •

Copy link
Copy Markdown
Contributor

Add SDK 3 upgrade summaries to the TypeScript, Python, and Java language pages, with direct links from the language-guide landing page and links to the released SDK migration guides. Preserve the existing 1.x-to-2.x guidance and anchors.

Use the current released package versions:

  • TypeScript: Core 3.0.0, OTel 2.0.0, and Testing 1.3.2.
  • Python: Core 3.0.0, OTel 2.0.0, Testing 1.4.0, and optional Telemetry Exporter 1.0.0.
  • Java: SDK, OTel, Testing, and optional Telemetry Exporter 3.0.0. Installation examples use SDK 3.0.0 and Lambda Java Core 1.4.1.

The summaries cover coordinated dependency and Lambda layer updates, plugin factories and providers, and replay/concurrency validation. TypeScript includes the testing-package upgrade order, hook scheduling, and invocation/OTel behavior changes. Python includes standalone OTel setup, string subtypes, retained None batch results, and hook threading. Java includes provider rebuilding, configuration copies, factory exclusivity, and telemetry-exporter recompilation and record-format guidance.

Related releases: TypeScript Core 3 / OTel 2, Python Core 3 / OTel 2, Python Telemetry Exporter 1.0.0, and Java 3.0.0.

Validation:

  • Zensical 0.0.40 clean site build passed with no issues.
  • Full-site Markdown formatting, spelling, and hidden-character checks passed.
  • All 675 example files remain referenced, with no broken includes; vendored Mermaid and GLightbox integrity checks passed.
  • Generated HTML package tables, Maven snippets, migration links, local links, and upgrade anchors checked successfully.
  • Package versions and compatibility checked against GitHub releases, Maven Central, npm, and PyPI.
  • git diff --check passed.
  • Browser preview was unavailable because the browser URL policy blocks local-file URLs; generated HTML was checked directly.

Complete migration code examples remain in the linked SDK guides.

@zhongkechen
zhongkechen deployed to ai-pr-review-runtime October 22, 2026 22:40 — with GitHub Actions Active

This branch had an error being deployed

1 failed deployment
ai-pr-review-runtime — cedbc44d Deployed Oct 27, 2026 by zhongkechen via ai-pr-review / Codex review / Generate Codex review #151
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