Skip to content

docs: clarify CMP discovery and timeout semantics in consentManagement TCF docs#6600

Open
patmmccann wants to merge 1 commit into
masterfrom
codex/fix-documentation-for-tcf-timeout-behavior
Open

docs: clarify CMP discovery and timeout semantics in consentManagement TCF docs#6600
patmmccann wants to merge 1 commit into
masterfrom
codex/fix-documentation-for-tcf-timeout-behavior

Conversation

@patmmccann

Copy link
Copy Markdown
Collaborator

Motivation

  • Clarify ambiguous behavior of gdpr.timeout and gdpr.actionTimeout so integrators understand Prebid's CMP discovery and waiting behavior.
  • Make examples explicit that Prebid waits only for an already-discovered CMP interface rather than polling for a CMP to appear.
  • Update the sample code link reference to the AppNexus CMP repository for clarity.

Description

  • Rewrote the gdpr.timeout table entry to state it applies to an already-discovered CMP interface and does not wait for a missing IAB CMP API/stub/locator to appear.
  • Rewrote the gdpr.actionTimeout table entry to state the action timer begins after an already-discovered CMP returns an initial/provisional response indicating user action is needed.
  • Inserted an explanatory paragraph before the TCF v2.x examples and updated Example 1 and Example 2 descriptions to reflect the discovery semantics.
  • Changed the sample code reference text to point to the AppNexus CMP repository link.

Testing

  • None — this is a documentation-only change and no automated tests were added or modified.
  • Existing CI will validate the documentation during automated runs.

Codex Task

### Motivation
- The existing doc text implied `gdpr.timeout` will wait for a missing IAB CMP API/stub/locator to appear, which contradicts Prebid.js behavior and related issues; the docs needed to explicitly describe the distinction between a missing CMP interface and a slow/awaiting CMP response.

### Description
- Updated the `gdpr.timeout` description to state it applies to an already-discovered CMP interface and does not poll for a missing IAB CMP API/stub/locator.
- Updated the `gdpr.actionTimeout` description to clarify the action timer begins after an already-discovered CMP returns an initial/provisional response indicating user action is needed.
- Rewrote Example 2 to explain the actual sequence (500ms applies only when the CMP interface is discoverable, otherwise lookup fails immediately).
- Replaced a non-descriptive link text and fixed the markdownlint `MD059` issue by using a descriptive link to the AppNexus CMP repository.

### Testing
- Ran `markdownlint --config .markdownlint.json dev-docs/modules/consentManagementTcf.md` and resolved the reported `MD059` error, after which linting passed.
- Ran `npm install -g markdownlint-cli` and `bundle install` to satisfy tooling, and then executed `bundle exec jekyll build`, which completed successfully.
@netlify

netlify Bot commented Jun 4, 2026

Copy link
Copy Markdown

Deploy Preview for prebid-docs-preview ready!

Name Link
🔨 Latest commit 93967c4
🔍 Latest deploy log https://app.netlify.com/projects/prebid-docs-preview/deploys/6a218cc123b5a100087ec26d
😎 Deploy Preview https://deploy-preview-6600--prebid-docs-preview.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@patmmccann patmmccann requested a review from dgirardi June 4, 2026 14:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant