[gewenyu99]

💡 Motivation and Context

The 7.x.x to 8.0.0 migration guide was hard to scan: a 21-item checklist of fragments, and long bullet walls. This PR sorts the guide by when you make each change, without changing what it says.

• Before you upgrade: proxy, project token, and OpenFeature provider.
• During your upgrade: changes that must ship in the same PR as the SDK bump.
• Follow ups: old names and options that 8.x.x still accepts.

Changes:

• The H1 is "Migrate the Python SDK from 7.x.x to 8.0.0".
• The checklist is three task lists, one per stage, and each item links to its section.
• Each stage is an H2, and each topic is an H3 under it.
• The retry, invalid-event, CaptureError, and $lib comparisons are tables.
• Versions use the x.x.x form, for example 7.x.x and 8.x.x.
• Table cells hold one value. The explanations are in the text below each table.
• The self-hosted PostHog notes are removed.
• The intro links to the Capture API (v1). The old /docs/libraries/capture-v1 link is gone.

Stacked on #1232, which this branch includes. The page title fix for posthog.com is in #1244.

Please check two additions: the 3-line before_send example in "Copy options in before_send", and the old and new tracing header names in "Rename deprecated settings".

💚 How did you test it?

All code blocks match the original except two comments (# 7.x.x, # 8.x.x). All 32 in-page links resolve. I previewed the page in a local posthog.com build.

📝 Checklist

• All commits are signed (see Commit signing)
• I reviewed the submitted code.
• I added tests to verify the changes.
• I updated the docs if needed.
• No breaking change or entry added to the changelog.

🤖 Generated with Claude Code

[veria-ai]

PR overview

No security issues were found in this pull request.

Reviews

• 07d32c5 — No new issues