docs: prefer docs.yml subpath for self-hosted base path#6221
docs: prefer docs.yml subpath for self-hosted base path#6221devin-ai-integration[bot] wants to merge 3 commits into
Conversation
Co-Authored-By: ryanstep <ryanstep@umich.edu>
🤖 Devin AI EngineerI'll be helping with this pull request! Here's what you should know: ✅ I will automatically:
Note: I can only respond to comments from users who have write access to this repository. ⚙️ Control Options:
|
|
🌿 Preview your docs: https://fern-preview-devin-1783968492-self-hosted-base-path.docs.buildwithfern.com/learn Here are the markdown pages you've updated: |
Co-Authored-By: ryanstep <ryanstep@umich.edu>
… reuse Co-Authored-By: ryanstep <ryanstep@umich.edu>
There was a problem hiding this comment.
Claude Code Review
Claude Code Review is paused for this repository. To reconnect it, an admin of this repository's GitHub organization (or the account owner, for personal repositories) who can also manage your Claude organization's Code Review settings needs to re-link GitHub in Code Review settings. This is a one-time step.
Tip: disable this comment in your organization's Code Review settings.
Summary
Reworks the "Base path" section of the self-hosted setup docs to reflect that Fern now infers the base path from the
docs.ymlinstance subpath, soNEXT_PUBLIC_BASE_PATHis no longer required.url+custom-domainindocs.yml:fern generate --docsvalidatesurlandcustom-domainshare the same base path, so the subpath goes on both or neither.NEXT_PUBLIC_BASE_PATHis now documented as an override that takes precedence over thedocs.ymlsubpath, retaining the build-time (readOnlyRootFilesystem-compatible) vs runtime patching tradeoffs under<Tabs>.NEXT_PUBLIC_BASE_PATHto describe it as an override and sets its default to "Inferred fromdocs.ymlsubpath (else serves from/)".Cross-reference sweep:
NEXT_PUBLIC_BASE_PATHand the env-var-only base path behavior only appear on this page; the domain/multi-source pages already describe thedocs.ymlurl/custom-domain subpath mechanism (cloud-hosted, reverse-proxy based), so no additional pointers were warranted.Validated with
pre-commit(0 Vale errors) andfern check --warnings(0 errors).Link to Devin session: https://app.devin.ai/sessions/7772aa172d854e61b7ff24189a239940