Prerequisites
Bug Description
Two issues in the Fern preview pipeline:
-
Preview build missing frozen version content — fern/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.
-
Preview comment swallows fern errors — OUTPUT=$(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
- Have versioned docs in
fern/versions/
- Open a PR touching
docs/ — preview build artifact is missing version content
- 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
Prerequisites
Bug Description
Two issues in the Fern preview pipeline:
Preview build missing frozen version content —
fern/versions/v1.2.0.yml,v1.3.0.yml,v1.4.0.ymlreferencevX.Y.Z-content/directories populated bygit archivein the publish workflow. The preview build workflow does not include this step, so the artifact ships empty directories. Preview generation will fail onceDOCS_FERN_TOKENis provisioned.Preview comment swallows fern errors —
OUTPUT=$(fern generate ... 2>&1)withbash -emeans the shell aborts beforeecho "$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
fern/versions/docs/— preview build artifact is missing version contentEnvironment
Logs/Output