Skip to content

docs(creative): clarify preview_creative renders manifests, not generates#4461

Draft
bokelley wants to merge 1 commit into
mainfrom
claude/issue-4452-preview-creative-render-clarification
Draft

docs(creative): clarify preview_creative renders manifests, not generates#4461
bokelley wants to merge 1 commit into
mainfrom
claude/issue-4452-preview-creative-render-clarification

Conversation

@bokelley
Copy link
Copy Markdown
Contributor

Closes #4452

The preview_creative task reference page opened with "Generate preview renderings" and its frontmatter description said "generates visual previews" — both misleading, since the task renders an existing manifest into viewable output and never generates or modifies it. Implementers choosing between preview_creative and build_creative had no explicit statement of the render/generate distinction on either page.

Changes:

  • preview_creative.mdx: frontmatter description changes "generates" → "renders an existing creative manifest into viewable output"; opening sentence replaced with an explicit render/generate distinction and cross-link to build_creative
  • build_creative.mdx: cross-link to preview_creative folded into the existing opening sentence so readers see the downstream render step immediately

Non-breaking justification: docs-only wording fix — no schema fields, enum values, or task definitions touched; existing consumers unaffected.

Pre-PR review:

  • code-reviewer: approved — no blockers; nit on build_creative.mdx opening sentence redundancy addressed in final diff
  • docs-expert: approved — accurate, agent-parseable, cross-links resolve to real files; nit on preview_creative.mdx "input manifest" wording incorporated

Triage-managed PR. This bot does not currently iterate on
review comments or PR conversation threads (only on the source
issue). To unblock:

  • Push fixup commits directly: gh pr checkout <num>
    fix → push.
  • Or re-trigger: comment /triage execute on the source
    issue.

See #3121
for context.

Session: https://claude.ai/code/session_01Ak6rrT9p3ZzeU6YY2y9o5p


Generated by Claude Code

…ates

preview_creative renders an existing creative manifest into viewable
output — it does not generate or modify the input manifest. The prior
opening sentence and frontmatter description both used "generates",
which caused implementers to conflate preview_creative with
build_creative. Fixes the wording on both pages and adds a mutual
cross-link so readers see the render/generate distinction immediately.

Closes #4452

https://claude.ai/code/session_01Ak6rrT9p3ZzeU6YY2y9o5p
@bokelley
Copy link
Copy Markdown
Contributor Author

Applying claude-triaged label to this PR per triage routine convention.


Generated by Claude Code

@bokelley bokelley added the claude-triaged Issue has been triaged by the Claude Code triage routine. Remove to re-triage. label May 12, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

claude-triaged Issue has been triaged by the Claude Code triage routine. Remove to re-triage.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs: preview_creative task page should explicitly state it renders manifests, not generates creatives

2 participants