Skip to content

[Bug]: Fern preview build missing frozen version content and swallowing errors #1284

Description

@pdmack

Prerequisites

  • I searched existing issues
  • I can reproduce this issue

Bug Description

Two issues in the Fern preview pipeline:

  1. Preview build missing frozen version contentfern/versions/v1.2.0.yml, v1.3.0.yml, v1.4.0.yml reference vX.Y.Z-content/ directories populated by git archive in the publish workflow. The preview build workflow does not include this step, so the artifact ships empty directories. Preview generation will fail once DOCS_FERN_TOKEN is provisioned.

  2. Preview comment swallows fern errorsOUTPUT=$(fern generate ... 2>&1) with bash -e means the shell aborts before echo "$OUTPUT" runs on failure, making errors invisible in the CI log.

Same issues found and fixed in NVIDIA/topograph#322.

Component

Documentation/CI

Steps to Reproduce

  1. Have versioned docs in fern/versions/
  2. Open a PR touching docs/ — preview build artifact is missing version content
  3. If fern generate fails, error output is swallowed

Environment

  • NVSentinel version: all (since versioned docs were added)
  • Kubernetes version: N/A
  • Deployment method: N/A

Logs/Output

# Preview generation fails silently because version content dirs are empty
# fern generate errors swallowed by OUTPUT=$(...) pattern

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't working

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions