Prerequisites
Bug Description
Two issues in the Fern preview pipeline:
-
Preview build missing frozen version content — The publish workflow uses git archive to populate fern/versions/v*-content/ from tagged releases, but the preview build workflow does not. PRs touching docs/ or fern/ fail preview generation because the versioned content directories are empty.
-
Preview comment swallows fern errors — OUTPUT=$(fern generate ... 2>&1) || true captures output into a variable, so errors are not streamed to the CI log in real time. If fern generate fails, the output is printed after the fact but the || true masks the exit code.
Impact
High (major functionality broken)
Component
Docs / examples
Regression?
Yes, this worked before (broken since versioned docs were added)
Steps to Reproduce
- Open a PR that touches
docs/
- Preview build succeeds but the artifact has empty version content directories
- Preview comment workflow fails to generate a preview URL
Expected Behavior
Preview build populates frozen version content via git archive (matching the publish workflow) and fern errors are streamed to the CI log.
Actual Behavior
Version content directories are empty and fern errors are captured into a variable, masking real-time output.
Prerequisites
Bug Description
Two issues in the Fern preview pipeline:
Preview build missing frozen version content — The publish workflow uses
git archiveto populatefern/versions/v*-content/from tagged releases, but the preview build workflow does not. PRs touchingdocs/orfern/fail preview generation because the versioned content directories are empty.Preview comment swallows fern errors —
OUTPUT=$(fern generate ... 2>&1) || truecaptures output into a variable, so errors are not streamed to the CI log in real time. Iffern generatefails, the output is printed after the fact but the|| truemasks the exit code.Impact
High (major functionality broken)
Component
Docs / examples
Regression?
Yes, this worked before (broken since versioned docs were added)
Steps to Reproduce
docs/Expected Behavior
Preview build populates frozen version content via
git archive(matching the publish workflow) and fern errors are streamed to the CI log.Actual Behavior
Version content directories are empty and fern errors are captured into a variable, masking real-time output.