Skip to content

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

Description

@pdmack

Prerequisites

  • I searched existing issues and found no duplicates
  • I can reproduce this issue consistently
  • This is not a security vulnerability

Bug Description

Two bugs in the Fern docs CI configuration:

  1. fern/docs.yml instances.url is missing the basepath — https://aicr.docs.buildwithfern.com should be https://aicr.docs.buildwithfern.com/aicr. Without the basepath, the published site URL is incorrect.

  2. publish-fern-docs.yml runs fern generate --docs as a bare command. The published URL is printed to the log but not surfaced as a step summary, making it hard to find after a publish run.

Impact

Medium (workaround exists)

Component

Docs / examples

Regression?

No, this is a new use case

Steps to Reproduce

  1. Trigger the publish workflow
  2. Note the published URL in the log — it includes the basepath but instances.url in docs.yml does not
  3. Note that no step summary link is generated after publish

Expected Behavior

  • instances.url includes the /aicr basepath
  • Publish step writes ### Published: [url](url) to the GitHub step summary

Actual Behavior

  • instances.url is https://aicr.docs.buildwithfern.com (missing basepath)
  • Publish step output is only in the raw log

Metadata

Metadata

Assignees

Labels

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