Skip to content

docs(reference): whats-new-in-3-1.mdx — 3.0 → 3.1 announcement page for beta drop#4784

Merged
bokelley merged 1 commit into
mainfrom
bokelley/whats-new-in-3-1
May 19, 2026
Merged

docs(reference): whats-new-in-3-1.mdx — 3.0 → 3.1 announcement page for beta drop#4784
bokelley merged 1 commit into
mainfrom
bokelley/whats-new-in-3-1

Conversation

@bokelley
Copy link
Copy Markdown
Contributor

@bokelley bokelley commented May 19, 2026 •
edited
Loading

New adopter-facing entry point for the 3.1 beta drop today. Comprehensive overview synthesized from a full audit of every spec PR merged since 3.0.6 (~52 spec-touching PRs).

What's here

docs/reference/whats-new-in-3-1.mdx — new page covering:

Corrections from earlier draft

Per feedback:

  • Canonical formats — explicitly call out status (framework + 9 canonicals stable in 3.1; 3 experimental; backwards-compatible with v1 format_ids via v1_format_ref dual emission).
  • "Wire-compatible" framing dropped. Was misleading. New framing: additive over 3.0, no breaking changes, but you should bump to pick up new fields.
  • webhook_activity[] reframed from "sellers want buyers to see..." to buyer self-service integration debug — friction reduction, not seller charity.
  • "Why upgrade" narrative added as a dedicated section near the top.
  • Comprehensive scope — earlier draft listed 8 features; this rewrite covers 15 (+ misc) after auditing every spec-touching PR since 3.0.6.

Test plan

  • test:docs-nav ✓
  • Mintlify broken-links check ✓ (after fixing 6 path drift errors caught by pre-push hook)
  • CI green
  • One reviewer eyeball on the at-a-glance table + headline ordering before announcement

🤖 Generated with Claude Code

@bokelley @claude
docs(reference): whats-new-in-3-1.mdx — 3.0 → 3.1 announcement-qualit…
90ffaf8 
…y page

Adopter-facing entry point for the 3.1 beta drop. Synthesizes the
headlines from release-notes.mdx into shorter, narrative content:

- At-a-glance 3.0 → 3.1 comparison table across 9 axes
- One-paragraph summaries of eight major features:
  distributed brand.json, dependency-impact webhooks, release-precision
  version negotiation, webhook foundation + buyer-side delivery
  visibility, windowed pull recovery, vendor-metric optimization goals,
  reach_window + viewed_seconds delivery reporting, canonical creative
  formats
- Adopter-action-by-role table covering 3.0 agents, buyers, sellers,
  sub-brand teams, measurement vendors, SDK authors
- Migration notes + links to release-notes.mdx and versioning.mdx

Distinct from whats-new-in-v3.mdx (v2 → v3 major). The 3.1 page links
back for major-version context and forward to release-notes.mdx for
per-PR detail.

Added to docs.json nav under both existing AdCP 3.0 groups.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@bokelley bokelley force-pushed the bokelley/whats-new-in-3-1 branch from 0ba4f6d to 90ffaf8 Compare May 19, 2026 14:32
@bokelley bokelley merged commit e01cbf9 into main May 19, 2026
15 checks passed
@bokelley bokelley deleted the bokelley/whats-new-in-3-1 branch May 19, 2026 16:57
@bokelley bokelley mentioned this pull request May 19, 2026
Merged
3 tasks
bokelley added a commit that referenced this pull request May 19, 2026
@bokelley
Revert "docs(reference): whats-new-in-3-1.mdx — 3.0 → 3.1 announcemen…
181d8b7 
…t-quality page (#4784)" (#4798)

This reverts commit e01cbf9.
@bokelley bokelley mentioned this pull request May 19, 2026
Merged
3 tasks
bokelley added a commit that referenced this pull request May 19, 2026
@bokelley @claude
docs(reference): re-apply whats-new-in-3-1.mdx (post-revert restore) (#…
e860906 
…4800)

Re-applies the 3.0 → 3.1 announcement page on a fresh branch from
current main. The original landing (PR #4784, commit e01cbf9)
accidentally deleted 1,131 dist/docs/ versioned-snapshot files because
its branch tree-state was based on a stale local main. That was
reverted in PR #4798 (commit 181d8b7), restoring the dist artifacts
but also removing this page.

This commit re-adds the page (content identical to the original) on a
clean branch base. Verified diff stat shows only 3 file changes
(docs/reference/whats-new-in-3-1.mdx + docs.json nav entries +
changeset) — no dist/ touch.

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@bokelley