Skip to content

docs(profiling): add CPython version upgrade runbook and 3.15 analysis - #17295

Closed
vlad-scherbich wants to merge 3 commits into
vlad/ddtracepy-upgrade-py-315-riot-reqsfrom
vlad/ddtracepy-upgrade-py-315-docs
Closed

docs(profiling): add CPython version upgrade runbook and 3.15 analysis#17295
vlad-scherbich wants to merge 3 commits into
vlad/ddtracepy-upgrade-py-315-riot-reqsfrom
vlad/ddtracepy-upgrade-py-315-docs

Conversation

@vlad-scherbich

@vlad-scherbich vlad-scherbich commented Apr 3, 2026

Copy link
Copy Markdown
Contributor

< Prev PR

https://datadoghq.atlassian.net/browse/PROF-14200

Description

Documentation for v3.14 - 3.15 migration PR: feat(profiling): support Python 3.15 (#17294).

Changes

  • docs/contributing-profiling-new-cpython.rst: new maintainer runbook for adding support for a new CPython minor version across the full Continuous Profiler stack (Echion/stack, asyncio, lock, memory/heap). Covers preparation, discovery, implementation checklist, and validation. References PR feat(profiling): [2/n][NO_MERGE] support Python 3.15 for profiling #17294 as the canonical 3.15 example.
  • docs/cpython-diffs/analysis_314_to_315.md: reference analysis of every 3.14→3.15 ABI change relevant to echion — per-item impact notes, completed checklist, and cross-references to the guards we added. Useful when doing the 3.16 port.
  • docs/contributing.rst: adds a link to the new runbook in the contributing index.
  • .claude/skills/compare-cpython-versions/SKILL.md: adds explicit enum-renumbering checklist item (silent correctness bug, not a compile error) and the static_assert / -Wswitch contract pattern as the recommended approach for catching future CPython regressions at build time.

@vlad-scherbich
vlad-scherbich requested review from a team as code owners April 3, 2026 02:00
@vlad-scherbich
vlad-scherbich requested a review from P403n1x87 April 3, 2026 02:00
@cit-pr-commenter-54b7da

cit-pr-commenter-54b7da Bot commented Apr 3, 2026

Copy link
Copy Markdown

Codeowners resolved as

ddtrace/internal/wrapping/context.py                                    @DataDog/apm-core-python
ddtrace/internal/wrapping/generators.py                                 @DataDog/apm-core-python

@vlad-scherbich
vlad-scherbich force-pushed the vlad/ddtracepy-upgrade-py-315-docs branch from bf7a9f8 to 1c63f88 Compare April 3, 2026 02:02
@vlad-scherbich
vlad-scherbich requested review from a team as code owners April 3, 2026 02:02
@vlad-scherbich
vlad-scherbich changed the base branch from main to vlad/ddtracepy-upgrade-py-315-feature April 3, 2026 02:02
@vlad-scherbich
vlad-scherbich marked this pull request as draft April 3, 2026 02:05
@vlad-scherbich
vlad-scherbich force-pushed the vlad/ddtracepy-upgrade-py-315-feature branch from dda683d to 619f17e Compare April 3, 2026 20:59
@vlad-scherbich vlad-scherbich added Profiling Continous Profling changelog/no-changelog A changelog entry is not required for this PR. labels Apr 6, 2026
@vlad-scherbich
vlad-scherbich force-pushed the vlad/ddtracepy-upgrade-py-315-feature branch from 88f1d5b to bceb1e6 Compare April 6, 2026 19:25
@vlad-scherbich
vlad-scherbich force-pushed the vlad/ddtracepy-upgrade-py-315-docs branch from 1c63f88 to b25ed6d Compare April 6, 2026 19:36
@vlad-scherbich
vlad-scherbich force-pushed the vlad/ddtracepy-upgrade-py-315-feature branch 4 times, most recently from a29014d to d3934e3 Compare April 14, 2026 02:03
@vlad-scherbich
vlad-scherbich deleted the branch vlad/ddtracepy-upgrade-py-315-riot-reqs April 14, 2026 02:04
@vlad-scherbich vlad-scherbich changed the title docs(profiling): add CPython version upgrade runbook and 3.15 analysis docs(profiling): [3/n] add CPython version upgrade runbook and 3.15 analysis Apr 14, 2026
@vlad-scherbich
vlad-scherbich force-pushed the vlad/ddtracepy-upgrade-py-315-feature branch from d3934e3 to 6e57d4b Compare April 15, 2026 21:15
@vlad-scherbich
vlad-scherbich force-pushed the vlad/ddtracepy-upgrade-py-315-docs branch from 0133198 to 3c2d6be Compare April 15, 2026 21:16
@vlad-scherbich
vlad-scherbich force-pushed the vlad/ddtracepy-upgrade-py-315-feature branch from 6e57d4b to f8bf205 Compare April 15, 2026 21:31
@vlad-scherbich
vlad-scherbich force-pushed the vlad/ddtracepy-upgrade-py-315-docs branch from 3c2d6be to 3ffa728 Compare April 15, 2026 21:32
@vlad-scherbich
vlad-scherbich force-pushed the vlad/ddtracepy-upgrade-py-315-feature branch from f8bf205 to 5419900 Compare April 15, 2026 21:46
@vlad-scherbich
vlad-scherbich force-pushed the vlad/ddtracepy-upgrade-py-315-docs branch 5 times, most recently from 15bb853 to 320cdee Compare April 15, 2026 21:50
@vlad-scherbich
vlad-scherbich force-pushed the vlad/ddtracepy-upgrade-py-315-feature branch from 5419900 to 6421eca Compare April 17, 2026 01:06
@vlad-scherbich
vlad-scherbich force-pushed the vlad/ddtracepy-upgrade-py-315-docs branch from 320cdee to c57e78b Compare April 17, 2026 01:06
@vlad-scherbich
vlad-scherbich force-pushed the vlad/ddtracepy-upgrade-py-315-feature branch 2 times, most recently from 4f37ced to 7513bb8 Compare April 17, 2026 12:40
@vlad-scherbich
vlad-scherbich changed the base branch from vlad/ddtracepy-upgrade-py-315-feature to vlad/ddtracepy-upgrade-py-315-riot-reqs April 17, 2026 12:49
vlad-scherbich and others added 2 commits April 17, 2026 08:50
- docs/contributing-profiling-new-cpython.rst: new maintainer runbook for
  adding support for a new CPython minor version across the Continuous Profiler
  (stack/asyncio/lock/memory/heap). References PR #17294 as the 3.15 example.
- docs/cpython-diffs/analysis_314_to_315.md: reference analysis of every
  3.14->3.15 ABI change relevant to echion, with echion impact notes and a
  completed checklist
- docs/contributing.rst: link to new runbook in the contributing index
- compare-cpython-versions skill: add enum-renumbering checklist item and
  static_assert / -Wswitch contract pattern for catching future regressions

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@vlad-scherbich
vlad-scherbich force-pushed the vlad/ddtracepy-upgrade-py-315-docs branch from c57e78b to 9ca7a80 Compare April 17, 2026 12:51
@vlad-scherbich vlad-scherbich changed the title docs(profiling): [3/n] add CPython version upgrade runbook and 3.15 analysis docs(profiling): [4/n] add CPython version upgrade runbook and 3.15 analysis Apr 27, 2026
@vlad-scherbich vlad-scherbich changed the title docs(profiling): [4/n] add CPython version upgrade runbook and 3.15 analysis docs(profiling): add CPython version upgrade runbook and 3.15 analysis Jun 2, 2026
@github-actions github-actions Bot added the stale label Jul 3, 2026
@github-actions

github-actions Bot commented Jul 5, 2026

Copy link
Copy Markdown
Contributor

This pull request has been automatically closed after a period of inactivity.
After this much time, it will likely be easier to open a new pull request with the
same changes than to update this one from the base branch. Please comment or reopen
if you think this pull request was closed in error.

@github-actions github-actions Bot closed this Jul 5, 2026
@vlad-scherbich
vlad-scherbich deleted the vlad/ddtracepy-upgrade-py-315-docs branch July 24, 2026 02:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

changelog/no-changelog A changelog entry is not required for this PR. Profiling Continous Profling stale

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant