Skip to content

docs: add "Try Fern as a guest" page for guest sessions and temporary sites - #7865

Merged
nerminamiller-postman merged 23 commits into
mainfrom
devin/1794604866-guest-fern-drop
Nov 19, 2026
Merged

nerminamiller-postman merged 23 commits into
mainfrom
devin/1794604866-guest-fern-drop

Conversation

@nerminamiller-postman

@nerminamiller-postman nerminamiller-postman commented Nov 13, 2026 •

Copy link
Copy Markdown
Collaborator

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:

  • Agent prompts (the two from Naman's team guide) and what the agent does before it stops at the claim link
  • Running it yourself: fern generate --docs --guest (temporary temp-<id> site, fern folder upload, --no-source) and fern generate --guest (download only, --preview, 7-day build page)
  • Claiming in the dashboard or with fern login + fern claim [--org] [--docs-url] [--sdk-name], then Connect GitHub (docs) or Publish to GitHub / Set up Fern repository (SDKs)
  • Expiration, usage limits, and a commands/options table

Sources: the Slack walkthrough, fern-guest-reference.pdf and fern-agent-guide.pdf from 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 --guest sections of docs-commands.mdx and sdk-commands.mdx. In the Dashboard docs, it adds a Claim guest work card on the overview and a sentence on the GitHub page pointing claimed sites and SDKs to Connect GitHub / Publish to GitHub.

The hidden agent get-started page (home/pages/agent-onboarding.mdx, served from the homepage prompt) now asks whether the user has a Fern account, points account-less users to the guest flow, and has the agent return the claim link and expiry and explain how to claim. Its human-visible note links to the claim section.

Naman's commit (#7879) adds fern claim --docs-url <slug> and --sdk-name <name> to the page, the fern claim reference in general-commands.mdx, and the hidden fern-instructions/new-site.mdx. It also documents that a claim moves the temporary site and SDK builds, updates a single-instance docs.yml URL, and keeps the guest session for a retry if a move fails.

Host names follow postman-eng/sdk-gen-fern-platform#1024: guest docs sites publish at temp-<id>.docs.buildwithfern.com (was drop-<id>), and "Fern Drop" stays an internal name. Merge after #1024 deploys to prod.

Open questions for reviewers

  • Numeric limits. The reference PDF says the limits (5 SDK build units and 10 docs publishes per session, a 3-hour session, the temporary-site caps, a 10-minute claim grant, a 30-day redirect) are service config that "can be changed without a code release" and are "not yet documented publicly". Are we OK publishing them? If not, I'll cut the two tables down to the behavior alone.
  • Overlap with open PRs. Document fern/ folder upload and --no-source for guest docs publishes #7795 (--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.
  • Dashboard button labels. The GitHub page says Connect repo in the Source section; the guest flow says Connect GitHub. Please confirm whether claimed temporary sites show a different button or the UI changed.

Link to Devin session: https://app.devin.ai/sessions/2b2d82f2c6684f429c1f37cb630b8296
Open in Devin Desktop: https://app.devin.ai/desktop/session/2b2d82f2c6684f429c1f37cb630b8296?variant=devin
Requested by: @nerminamiller-postman


🟢 Devin Review found nothing to fix · View findings · Follow Devin's work

Devin Review

…n Drop

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
@devin-ai-integration

Copy link
Copy Markdown
Contributor

I'll fix CI failures and address comments from users with write access. I'll skip comments containing "(aside)".

  • Disable automatic comment, CI, and merge conflict monitoring

@devin-ai-integration devin-ai-integration Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no bugs or issues to report.

Devin Review

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
@devin-ai-integration

Copy link
Copy Markdown
Contributor

Preview links for the changed pages. The page now lives under Docs > Getting started. The bot's learn/docs/try-without-account link is stale and 404s.

Written by Devin

…t-fern-drop

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>

# Conflicts:
#	fern/fern.config.json
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
@devin-ai-integration

Copy link
Copy Markdown
Contributor

…ts for 30 days

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
github-actions[bot]

This comment was marked as resolved.

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
@devin-ai-integration devin-ai-integration Bot changed the title docs: add "Try Fern without an account" page for guest sessions and Fern Drop docs: add "Try Fern without an account" page for guest sessions and temporary sites Nov 18, 2026
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
…d SDKs

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
…claim step

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
…t-fern-drop

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>

# Conflicts:
#	fern/products/cli-api-reference/pages/docs-commands.mdx
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
…mpt buttons

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"]}
>
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?

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📝 [vale] <FernStyles.FirstPerson> reported by reviewdog 🐶
Use first person (such as 'I') sparingly.

title="Create a docs site from an OpenAPI spec"
actions={["cursor"]}
>
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?

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📝 [vale] <FernStyles.FirstPerson> reported by reviewdog 🐶
Use first person (such as ' I') sparingly.

title="Create a docs site from an OpenAPI spec"
actions={["cursor"]}
>
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?

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📝 [vale] <FernStyles.FirstPerson> reported by reviewdog 🐶
Use first person (such as 'me') sparingly.

title="Create a docs site from an OpenAPI spec"
actions={["cursor"]}
>
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?

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📝 [vale] <Microsoft.QuestionMarks> reported by reviewdog 🐶
Use questions sparingly.

title="Generate an SDK from an OpenAPI spec"
actions={["cursor"]}
>
I have this OpenAPI spec `./openapi.yml` and I need to generate an SDK for this using Fern. Can you do this for me?

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📝 [vale] <FernStyles.FirstPerson> reported by reviewdog 🐶
Use first person (such as 'I') sparingly.

title="Generate an SDK from an OpenAPI spec"
actions={["cursor"]}
>
I have this OpenAPI spec `./openapi.yml` and I need to generate an SDK for this using Fern. Can you do this for me?

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📝 [vale] <FernStyles.FirstPerson> reported by reviewdog 🐶
Use first person (such as ' I') sparingly.

title="Generate an SDK from an OpenAPI spec"
actions={["cursor"]}
>
I have this OpenAPI spec `./openapi.yml` and I need to generate an SDK for this using Fern. Can you do this for me?

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📝 [vale] <FernStyles.FirstPerson> reported by reviewdog 🐶
Use first person (such as 'me') sparingly.

title="Generate an SDK from an OpenAPI spec"
actions={["cursor"]}
>
I have this OpenAPI spec `./openapi.yml` and I need to generate an SDK for this using Fern. Can you do this for me?

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📝 [vale] <Microsoft.QuestionMarks> reported by reviewdog 🐶
Use questions sparingly.

@devin-ai-integration devin-ai-integration Bot changed the title docs: add "Try Fern without an account" page for guest sessions and temporary sites docs: add "Try Fern as a guest" page for guest sessions and temporary sites Nov 19, 2026
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
@nerminamiller-postman
nerminamiller-postman merged commit 186c89f into main Nov 19, 2026
5 checks passed
@nerminamiller-postman
nerminamiller-postman deleted the devin/1794604866-guest-fern-drop branch November 19, 2026 20:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants