Repository navigation
docs: add "Try Fern as a guest" page for guest sessions and temporary sites - #7865
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>
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>
|
Preview links for the changed pages. The page now lives under Docs > Getting started. The bot's
|
…--docs-url, --sdk-name) (#7879)
…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>
|
Preview links for the new Dashboard cross-references:
|
…ts for 30 days 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>
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>
…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? |
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"]} | ||
| > | ||
| 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"]} | ||
| > | ||
| 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"]} | ||
| > | ||
| 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"]} | ||
| > | ||
| 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"]} | ||
| > | ||
| 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"]} | ||
| > | ||
| 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"]} | ||
| > | ||
| 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.
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>
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(temporarytemp-<id>site,fernfolder upload,--no-source) andfern generate --guest(download only,--preview, 7-day build page)fern login+fern claim [--org] [--docs-url] [--sdk-name], 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. 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, thefern claimreference ingeneral-commands.mdx, and the hiddenfern-instructions/new-site.mdx. It also documents that a claim moves the temporary site and SDK builds, updates a single-instancedocs.ymlURL, 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(wasdrop-<id>), and "Fern Drop" stays an internal name. Merge after #1024 deploys to prod.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/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