Skip to main content
Doctorine reference
On this pageOverview

Publish diagnostic reference

Catalog of every positioned publish diagnostic: severity, remediation, and docs anchors.

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 thePUBLISH_CODES catalog. Findings link here viadocsUrl.

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.

  • Raw HTML outside the admitted vocabulary was dropped

    Code
    DT_PUBLISH_HTML_STRIPPED
    Category
    guides
    Severity
    warning

    Raw HTML outside the admitted vocabulary was dropped

    Fix: The named tags do not render on the portal; rewrite them as Markdown, a Doctorine block, or an admitted HTML element.

  • 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.

  • Block source published as text

    Code
    DT_PUBLISH_BLOCK_LITERAL_SOURCE
    Category
    guides
    Severity
    warning

    Block source published as text

    Fix: Put the block on its own line; a "::block{…}" run after prose is not a block.

  • Image has no uploaded source

    Code
    DT_PUBLISH_UNRESOLVED_MEDIA
    Category
    guides
    Severity
    warning

    Image has no uploaded source

    Fix: Upload the image, or remove the reference; each finding says what readers see meanwhile.

  • 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.

  • Framework landing page was replaced

    Code
    portal/root-landing-blank
    Category
    guides
    Severity
    info

    Framework landing page was replaced

    Fix: Author the landing in Markdown with a heading, prose, or links to publish it as the portal home page.

  • Unsupported component was neutralized

    Code
    portal/unknown-jsx-neutralized
    Category
    guides
    Severity
    warning

    Unsupported component was neutralized

    Fix: Replace foreign components with Markdown or a supported Doctorine block.

  • Raw angle token was rendered as prose

    Code
    portal/raw-angle-neutralized
    Category
    guides
    Severity
    info

    Raw angle token was rendered as prose

    Fix: Use an HTML entity or inline code when an angle token is intended as literal prose.

  • Unsupported HTML attribute was dropped

    Code
    portal/html-attribute-dropped
    Category
    guides
    Severity
    warning

    Unsupported HTML attribute was dropped

    Fix: Use the portal vocabulary instead of presentational HTML attributes.

  • Site-generator shortcode was removed

    Code
    portal/shortcode-unsupported
    Category
    guides
    Severity
    warning

    Site-generator shortcode was removed

    Fix: Replace site-generator macros with Markdown, MDX, or a supported Doctorine block.

envelope

  • Portal build failed

    Code
    DT_PUBLISH_ASTRO_BUILD
    Category
    envelope
    Severity
    error

    Portal build failed

    Fix: Read the build transcript in the finding, fix the named page or asset, and publish again.

  • 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.

Documentation menu