Publish diagnostic reference

Every diagnostic code the publish pipeline can emit (guide validation, envelope checks, audit-gate failures, asset budgets). Severity, remediation, and the fragment on this page all come from the PUBLISH_CODES catalog. Findings link here via docsUrl.

guides

• Guide field failed validation

  Code

  DT_PUBLISH_GUIDE_INVALID

  Category

  guides

  Severity

  error

  Guide field failed validation

  Fix: Fix the named guide field (slug, title, parent, body, or metadata).

• Duplicate guide slug

  Code

  DT_PUBLISH_GUIDE_DUPLICATE_SLUG

  Category

  guides

  Severity

  error

  Duplicate guide slug

  Fix: Give each guide a unique slug before publishing.

• Guide slugs share a published route

  Code

  DT_PUBLISH_GUIDE_ROUTE_COLLISION

  Category

  guides

  Severity

  error

  Guide slugs share a published route

  Fix: Rename one of the colliding slugs so published paths stay unique.

• Guide parent slug is missing

  Code

  DT_PUBLISH_GUIDE_PARENT_MISSING

  Category

  guides

  Severity

  error

  Guide parent slug is missing

  Fix: Point parentSlug at an existing guide, or clear it for a root page.

• Guide cannot parent itself

  Code

  DT_PUBLISH_GUIDE_PARENT_SELF

  Category

  guides

  Severity

  error

  Guide cannot parent itself

  Fix: Remove the self-parent or point parentSlug at a different guide.

• Guide hierarchy has a cycle

  Code

  DT_PUBLISH_GUIDE_HIERARCHY_CYCLE

  Category

  guides

  Severity

  error

  Guide hierarchy has a cycle

  Fix: Break the parent cycle so every guide has a finite ancestry.

• Guides payload is not an array

  Code

  DT_PUBLISH_GUIDES_NOT_ARRAY

  Category

  guides

  Severity

  error

  Guides payload is not an array

  Fix: Send guides as a JSON array of guide objects.

• Block did not render and was degraded

  Code

  DT_PUBLISH_BLOCK_DEGRADED

  Category

  guides

  Severity

  warning

  Block did not render and was degraded

  Fix: Fix the block name or its attributes; each finding names what readers get meanwhile.

• Broken internal link in content

  Code

  DT_VALIDATE_BROKEN_LINK

  Category

  guides

  Severity

  error

  Broken internal link in content

  Fix: Check the path, or create the target page.

• Broken heading anchor in content

  Code

  DT_VALIDATE_BROKEN_ANCHOR

  Category

  guides

  Severity

  warning

  Broken heading anchor in content

  Fix: Point the fragment at a heading that exists on the target page.

• Missing asset reference in content

  Code

  DT_VALIDATE_BROKEN_ASSET

  Category

  guides

  Severity

  warning

  Missing asset reference in content

  Fix: Add the file under public/ or fix the reference.

envelope

• Publish envelope field failed validation

  Code

  DT_PUBLISH_ENVELOPE_INVALID

  Category

  envelope

  Severity

  error

  Publish envelope field failed validation

  Fix: Fix the named top-level build field (ids, baseUrl, branding, …).

• API sidebar selection matched no operations

  Code

  DT_PUBLISH_API_NAV_TOTAL_MISS

  Category

  envelope

  Severity

  warning

  API sidebar selection matched no operations

  Fix: Correct the "METHOD /path" lines in the API publisher settings, or clear the list to list every operation.

audit

• Static audit gate failed the publish

  Code

  DT_PUBLISH_AUDIT_FAILED

  Category

  audit

  Severity

  error

  Static audit gate failed the publish

  Fix: Resolve the listed audit findings, then republish.

budget

• Client asset budget exceeded

  Code

  DT_PUBLISH_BUDGET_EXCEEDED

  Category

  budget

  Severity

  error

  Client asset budget exceeded

  Fix: Reduce portal client JS/CSS or raise the configured budget.

• Client asset budget near the ceiling

  Code

  DT_PUBLISH_BUDGET_WARNING

  Category

  budget

  Severity

  warning

  Client asset budget near the ceiling

  Fix: Client JS/CSS is above 90% of the configured budget.

Publish diagnostic reference · Audit check reference