Document "version redirection disabled" message and fern api update "Mi… - #7025
fern-api[bot] wants to merge 1 commit into
Conversation
| <llms-only> | ||
| ### "Missing file" error | ||
|
|
||
| `fern api update` downloads the remote spec and overwrites the local file referenced by the `openapi:` path in `generators.yml`. The target file must already exist on disk before the command runs — the command updates an existing file in place and does not create new files. |
There was a problem hiding this comment.
🚫 [vale] <Microsoft.Contractions> reported by reviewdog 🐶
Use 'doesn't' instead of 'does not'.
| `fern api update` downloads the remote spec and overwrites the local file referenced by the `openapi:` path in `generators.yml`. The target file must already exist on disk before the command runs — the command updates an existing file in place and does not create new files. | |
| `fern api update` downloads the remote spec and overwrites the local file referenced by the `openapi:` path in `generators.yml`. The target file must already exist on disk before the command runs — the command updates an existing file in place and doesn't create new files. |
|
|
||
| A [`path:`](/learn/docs/configuration/navigation) in `docs.yml` points to a file that isn't on disk. Fix the path or create the missing file. Paths are relative to the YAML file that defines them. | ||
|
|
||
| #### "Version redirection is disabled, so it was not upgraded" |
There was a problem hiding this comment.
🚫 [vale] <Microsoft.Contractions> reported by reviewdog 🐶
Use 'wasn't' instead of 'was not'.
| #### "Version redirection is disabled, so it was not upgraded" | |
| #### "Version redirection is disabled, so it wasn't upgraded" |
|
|
||
| #### "Version redirection is disabled, so it was not upgraded" | ||
|
|
||
| This message is informational. It appears when the CLI cannot redirect to a different version — for example, because the organization's version policy cannot be reached, or because the CLI is running in an environment where version redirection is suppressed. The command still runs using the locally pinned version from `fern.config.json`. It is safe to ignore during local development. |
There was a problem hiding this comment.
🚫 [vale] <Microsoft.Contractions> reported by reviewdog 🐶
Use 'can't' instead of 'cannot'.
| This message is informational. It appears when the CLI cannot redirect to a different version — for example, because the organization's version policy cannot be reached, or because the CLI is running in an environment where version redirection is suppressed. The command still runs using the locally pinned version from `fern.config.json`. It is safe to ignore during local development. | |
| This message is informational. It appears when the CLI can't redirect to a different version — for example, because the organization's version policy cannot be reached, or because the CLI is running in an environment where version redirection is suppressed. The command still runs using the locally pinned version from `fern.config.json`. It is safe to ignore during local development. |
|
|
||
| #### "Version redirection is disabled, so it was not upgraded" | ||
|
|
||
| This message is informational. It appears when the CLI cannot redirect to a different version — for example, because the organization's version policy cannot be reached, or because the CLI is running in an environment where version redirection is suppressed. The command still runs using the locally pinned version from `fern.config.json`. It is safe to ignore during local development. |
There was a problem hiding this comment.
🚫 [vale] <Microsoft.Contractions> reported by reviewdog 🐶
Use 'can't' instead of 'cannot'.
| This message is informational. It appears when the CLI cannot redirect to a different version — for example, because the organization's version policy cannot be reached, or because the CLI is running in an environment where version redirection is suppressed. The command still runs using the locally pinned version from `fern.config.json`. It is safe to ignore during local development. | |
| This message is informational. It appears when the CLI cannot redirect to a different version — for example, because the organization's version policy can't be reached, or because the CLI is running in an environment where version redirection is suppressed. The command still runs using the locally pinned version from `fern.config.json`. It is safe to ignore during local development. |
|
|
||
| #### "Version redirection is disabled, so it was not upgraded" | ||
|
|
||
| This message is informational. It appears when the CLI cannot redirect to a different version — for example, because the organization's version policy cannot be reached, or because the CLI is running in an environment where version redirection is suppressed. The command still runs using the locally pinned version from `fern.config.json`. It is safe to ignore during local development. |
There was a problem hiding this comment.
🚫 [vale] <Microsoft.Contractions> reported by reviewdog 🐶
Use 'it's' instead of 'It is'.
| This message is informational. It appears when the CLI cannot redirect to a different version — for example, because the organization's version policy cannot be reached, or because the CLI is running in an environment where version redirection is suppressed. The command still runs using the locally pinned version from `fern.config.json`. It is safe to ignore during local development. | |
| This message is informational. It appears when the CLI cannot redirect to a different version — for example, because the organization's version policy cannot be reached, or because the CLI is running in an environment where version redirection is suppressed. The command still runs using the locally pinned version from `fern.config.json`. it's safe to ignore during local development. |
|
🌿 Preview your docs: https://fern-preview-2026-09-21-fern-ai-d8be69-c84a544d.docs.buildwithfern.com/learn Here are the markdown pages you've updated: |
Added
<llms-only>documentation for two undocumented CLI behaviors that were generating Ask AI gaps. In thefern docs devaccordion (docs-commands.mdx), added a note explaining that "Version redirection is disabled, so it was not upgraded" is informational — the command still runs on the locally pinned version fromfern.config.jsonand can be safely ignored during local development. The same entry was added to the Common errors<llms-only>section inpreview-changes-locally.mdx. In thefern api updateaccordion (general-commands.mdx), added a note explaining that the target OpenAPI file must already exist on disk before the command runs, with atouchexample showing how to create the placeholder first.