Skip to content

docs: 'when to use which proposal surface' guide #517

@bokelley

Description

@bokelley

From the salesagent v3.12 → 4.x migration (SDK_FEEDBACK.md, item #12).

Two proposal-related surfaces with overlapping names:

Adopters have to know which to use when. The names overlap.

Ask

A docs section in docs/proposals/ that maps "I want to..." → "use this surface."

Suggested table shape:

Goal Surface
Stand up a non-guaranteed seller that doesn't need proposal state adcp.server.proposal.proposals_not_supported
Build allocation responses inline in a request handler adcp.server.proposal.AllocationBuilder
Manage proposal lifecycle (multi-tenant, async) adcp.decisioning.ProposalManager

(Owner can refine; the point is to give adopters a one-page picker.)

Metadata

Metadata

Assignees

No one assigned

    Labels

    claude-triagingTriage routine is actively working on this issue (1-3 min)documentationImprovements or additions to documentation

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions