docs: add v2 -> v3 version lifecycle table to README#5979
Merged
Conversation
jam-jee
force-pushed
the
docs/v2-lifecycle-table
branch
from
8bac670 to
c048dbd
Compare
Document the SageMaker Python SDK version lifecycle per the AWS SDKs and Tools maintenance policy. Adds a "Version Lifecycle" section (and a Table of Contents entry) to the v2 README stating that v3 is GA (2025-11-19) and the actively developed major version, and that v2 is in maintenance mode. Includes a Phase / Start Date / End Date table (GA, Maintenance mode, End-of-Support) modeled on the AWS SDK for Java v1 lifecycle table, the per-phase support definitions, the migration-guide link, and the v2-pin / v3-upgrade pip commands. Dates aligned with product: maintenance mode 2026-07-06 to 2027-07-05 (12 months), end-of-support 2027-07-06.
jam-jee
force-pushed
the
docs/v2-lifecycle-table
branch
from
c048dbd to
ea32246
Compare
mufaddal-rohawala
approved these changes
Jul 1, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Issue #, if available: N/A
Description of changes:
Adds a Version Lifecycle section to the v2 README documenting the SageMaker Python SDK lifecycle per the AWS SDKs and Tools maintenance policy.
The section states that v3 is GA (2025-11-19) and the actively developed major version, that v2 is in maintenance mode (critical bug fixes + security only), and includes:
pip install "sagemaker<3"(pin) /pip install --upgrade sagemaker(upgrade) commands.Also adds a Table of Contents entry. Dates were aligned with the product team following the policy (maintenance announcement anchored to v3 GA; +6 months to maintenance, +12 months to end-of-support). v2.0.0 GA date (2020-08-04) confirmed from PyPI.
This complements the runtime deprecation-warning work in #5978 (the policy lists both updated docs and in-SDK deprecation warnings as required communication channels).
Testing done:
Docs-only change. Validated that
README.rstparses cleanly with docutils (no RST errors; simple-table columns align). No code changed.Merge Checklist
By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license.