Repository navigation
docs: add "Try Fern without an account" page for guest sessions and Fern Drop - #7865
nerminamiller-postman wants to merge 4 commits into
Conversation
…n Drop Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
|
I'll fix CI failures and address comments from users with write access. I'll skip comments containing "(aside)".
|
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
|
🌿 Preview your docs: https://fern-preview-devin-1794604866-guest-fern-drop.docs.buildwithfern.com/learn Here are the markdown pages you've updated: |
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
| ``` | ||
|
|
||
| [`--guest`](/learn/cli-api-reference/cli-reference/docs-commands#guest) starts a temporary guest session and publishes your site to a `drop-<id>.docs.buildwithfern.com` URL, ignoring the `organization` in `fern.config.json` and the URL in `docs.yml`. The output includes a claim link; open it (or run [`fern claim`](/learn/cli-api-reference/cli-reference/general-commands#fern-claim) after `fern login`) to move the site into your organization before the session expires. Guest publishing needs CLI 5.182.0 or later: the `version` in `fern.config.json` is what runs, so run [`fern upgrade`](/learn/cli-api-reference/cli-reference/general-commands#fern-upgrade) if yours is older. Guest sessions aren't available on every Fern environment yet; if the CLI reports `Could not start a guest session`, log in and publish normally. | ||
| [`--guest`](/learn/cli-api-reference/cli-reference/docs-commands#guest) starts a temporary guest session and publishes your site to a `drop-<id>.docs.buildwithfern.com` URL, ignoring the `organization` in `fern.config.json` and the URL in `docs.yml`. The output includes a claim link; open it (or run [`fern claim`](/learn/cli-api-reference/cli-reference/general-commands#fern-claim) after `fern login`) to move the site into your organization before the session expires. See [Try Fern without an account](/learn/docs/getting-started/try-without-account) for the full flow, limits, and expiration. Guest publishing needs CLI 5.182.0 or later: the `version` in `fern.config.json` is what runs, so run [`fern upgrade`](/learn/cli-api-reference/cli-reference/general-commands#fern-upgrade) if yours is older. Guest sessions aren't available on every Fern environment yet; if the CLI reports `Could not start a guest session`, log in and publish normally. |
There was a problem hiding this comment.
📝 [vale] <Microsoft.OxfordComma> reported by reviewdog 🐶
Use the Oxford comma in ', log in and publish normally.'.
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
| title="Create a docs site from an OpenAPI spec" | ||
| actions={["cursor", "claude", "chatgpt"]} | ||
| > | ||
| I have this OpenAPI spec `./openapi.yml` and I need to create a docs website for this spec using Fern. Can you do this for me? |
There was a problem hiding this comment.
📝 [vale] <FernStyles.FirstPerson> reported by reviewdog 🐶
Use first person (such as 'I') sparingly.
| title="Create a docs site from an OpenAPI spec" | ||
| actions={["cursor", "claude", "chatgpt"]} | ||
| > | ||
| I have this OpenAPI spec `./openapi.yml` and I need to create a docs website for this spec using Fern. Can you do this for me? |
There was a problem hiding this comment.
📝 [vale] <FernStyles.FirstPerson> reported by reviewdog 🐶
Use first person (such as ' I') sparingly.
| title="Create a docs site from an OpenAPI spec" | ||
| actions={["cursor", "claude", "chatgpt"]} | ||
| > | ||
| I have this OpenAPI spec `./openapi.yml` and I need to create a docs website for this spec using Fern. Can you do this for me? |
There was a problem hiding this comment.
📝 [vale] <FernStyles.FirstPerson> reported by reviewdog 🐶
Use first person (such as 'me') sparingly.
| title="Create a docs site from an OpenAPI spec" | ||
| actions={["cursor", "claude", "chatgpt"]} | ||
| > | ||
| I have this OpenAPI spec `./openapi.yml` and I need to create a docs website for this spec using Fern. Can you do this for me? |
There was a problem hiding this comment.
📝 [vale] <Microsoft.QuestionMarks> reported by reviewdog 🐶
Use questions sparingly.
| title="Generate an SDK from an OpenAPI spec" | ||
| actions={["cursor", "claude", "chatgpt"]} | ||
| > | ||
| I have this OpenAPI spec `./openapi.yml` and I need to generate an SDK for this using Fern. Can you do this for me? |
There was a problem hiding this comment.
📝 [vale] <FernStyles.FirstPerson> reported by reviewdog 🐶
Use first person (such as 'I') sparingly.
| title="Generate an SDK from an OpenAPI spec" | ||
| actions={["cursor", "claude", "chatgpt"]} | ||
| > | ||
| I have this OpenAPI spec `./openapi.yml` and I need to generate an SDK for this using Fern. Can you do this for me? |
There was a problem hiding this comment.
📝 [vale] <FernStyles.FirstPerson> reported by reviewdog 🐶
Use first person (such as ' I') sparingly.
| title="Generate an SDK from an OpenAPI spec" | ||
| actions={["cursor", "claude", "chatgpt"]} | ||
| > | ||
| I have this OpenAPI spec `./openapi.yml` and I need to generate an SDK for this using Fern. Can you do this for me? |
There was a problem hiding this comment.
📝 [vale] <FernStyles.FirstPerson> reported by reviewdog 🐶
Use first person (such as 'me') sparingly.
| title="Generate an SDK from an OpenAPI spec" | ||
| actions={["cursor", "claude", "chatgpt"]} | ||
| > | ||
| I have this OpenAPI spec `./openapi.yml` and I need to generate an SDK for this using Fern. Can you do this for me? |
There was a problem hiding this comment.
📝 [vale] <Microsoft.QuestionMarks> reported by reviewdog 🐶
Use questions sparingly.
|
Preview links for the changed pages. The page now lives under Docs > Getting started. The bot's
|
Summary
Adds a visible, canonical page for the no-account flow, at
/learn/docs/getting-started/try-without-account(Docs > Getting started, after Quickstart). Before this, guest mode only had short notes in the CLI reference, the Docs quickstart, and the hidden agent instructions.The page covers:
fern generate --docs --guest(Fern Dropdrop-<id>site,fernfolder upload,--no-source) andfern generate --guest(download only,--preview, 7-day build page)fern login+fern claim [--org], then Connect GitHub (docs) or Publish to GitHub / Set up Fern repository (SDKs)Sources: the Slack walkthrough,
fern-guest-reference.pdfandfern-agent-guide.pdffrom that thread, and the CLI source (resolveGuestProject.ts,describeGuestRejection.ts,claimGuestSession.ts).Also adds one-line links to the page from the Docs quickstart and the
--guestsections ofdocs-commands.mdxandsdk-commands.mdx.Bumps
fern/fern.config.jsonfrom CLI 5.204.1 to 5.215.2 to unblock the preview build (CLI 5.215.0+ refuses to run projects pinned below it). Same change as #7866; whichever merges first, the other rebases cleanly.Open questions for reviewers
--no-source) and fern instructions: ask the user before using --guest #7838 (ask before--guest) touch the same CLI reference sections. This PR only adds one sentence there, so any conflicts should be trivial.Link to Devin session: https://app.devin.ai/sessions/0923b7af18b546cc9f9775c05e4f1b69
Open in Devin Desktop: https://app.devin.ai/desktop/session/0923b7af18b546cc9f9775c05e4f1b69?variant=devin
Requested by: @nerminamiller-postman
🟢 Devin Review found nothing to fix · View findings