Skip to content

fix(ci): fix fern instances URL basepath and surface publish URL in step summary#568

Merged
mchmarny merged 1 commit into
NVIDIA:mainfrom
pdmack:pdmack/fern-ci-fix3
Apr 14, 2026
Merged

fix(ci): fix fern instances URL basepath and surface publish URL in step summary#568
mchmarny merged 1 commit into
NVIDIA:mainfrom
pdmack:pdmack/fern-ci-fix3

Conversation

@pdmack

@pdmack pdmack commented Apr 14, 2026

Copy link
Copy Markdown
Contributor

Summary

Fix two bugs in the Fern docs CI configuration: missing basepath in instances.url and publish step not surfacing the published URL.

Motivation / Context

Fixes: #567
Related: N/A

Type of Change

  • Bug fix (non-breaking change that fixes an issue)
  • Build/CI/tooling

Component(s) Affected

  • Docs/examples (docs/, examples/)

Implementation Notes

  1. fern/docs.yml instances.url was https://aicr.docs.buildwithfern.com — missing the /aicr basepath required by basepath-aware: true. Verified by running fern generate --docs --preview locally; the correct URL is https://aicr.docs.buildwithfern.com/aicr.

  2. publish-fern-docs.yml ran fern generate --docs as a bare command. Now captures output, extracts the published URL (stripping the duplicate parenthesised copy that breaks GitHub's auto-linker), and writes it to the job step summary.

Testing

Verified fern generate --docs --preview locally — preview published successfully at https://nvidia-preview-test-preview.docs.buildwithfern.com/aicr. URL extraction regex confirmed against actual output.

Risk Assessment

  • Low — Isolated change, well-tested, easy to revert

Rollout notes: N/A

Checklist

  • I did not skip/disable tests to make CI green
  • Changes follow existing patterns in the codebase
  • Commits are cryptographically signed (git commit -S)

@github-actions

Copy link
Copy Markdown
Contributor

@mchmarny mchmarny merged commit f489db3 into NVIDIA:main Apr 14, 2026
27 checks passed
@pdmack pdmack deleted the pdmack/fern-ci-fix3 branch April 20, 2026 17:00
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Bug]: fern docs.yml instances URL missing basepath and publish step drops output URL

2 participants