diff --git a/fern/assets/styles.css b/fern/assets/styles.css index cd641a71..ca8c4302 100644 --- a/fern/assets/styles.css +++ b/fern/assets/styles.css @@ -1093,4 +1093,20 @@ a[href*="changelog"] svg { .modify-snippet tbody tr:last-of-type td:last-of-type .line span:last-of-type:before { content: "/"; display: inline-block; -} \ No newline at end of file +} + +/*** START -- FERN EDITOR STYLING ***/ +.fe-action-button { + display: flex; + flex-direction: row; + gap: 1rem; + align-items: center; + justify-content: space-between; + text-decoration: none; + color: var(--grayscale-12); + + svg.external-link-icon { + display: none; + } +} +/*** END -- FERN EDITOR STYLING ***/ \ No newline at end of file diff --git a/fern/products/cli-api-reference/cli-changelog/2025-09-22.mdx b/fern/products/cli-api-reference/cli-changelog/2025-09-22.mdx index 9dc61a23..389c7112 100644 --- a/fern/products/cli-api-reference/cli-changelog/2025-09-22.mdx +++ b/fern/products/cli-api-reference/cli-changelog/2025-09-22.mdx @@ -1,6 +1,5 @@ ## 0.78.4 -**`(fix):`** Collapse any combination of optional and nullable to optional>. +**`(fix):`** Collapse any combination of optional and nullable to `optional>`. ## 0.78.3 **`(chore):`** Support IR v59 in the Rust SDK generator. - diff --git a/fern/products/docs/docs.yml b/fern/products/docs/docs.yml index 92e855ea..827e0677 100644 --- a/fern/products/docs/docs.yml +++ b/fern/products/docs/docs.yml @@ -95,7 +95,7 @@ navigation: - page: Tooltips path: ./pages/component-library/default-components/tooltips.mdx icon: fa-duotone fa-comment - - page: Visual Editor + - page: Fern Editor path: ./pages/component-library/writing-content/visual-editor.mdx - page: Reusable snippets path: ./pages/component-library/custom-components/reusable-markdown.mdx diff --git a/fern/products/docs/pages/authentication/sso.mdx b/fern/products/docs/pages/authentication/sso.mdx index 6c362121..ef3e3c9a 100644 --- a/fern/products/docs/pages/authentication/sso.mdx +++ b/fern/products/docs/pages/authentication/sso.mdx @@ -11,7 +11,7 @@ Fern’s Single Sign-On (SSO) is an enterprise feature that lets your team secur When SSO is enabled for your organization, authenticated users of Fern can: -- **Use the Visual Editor**: Make edits to your docs from the browser +- **Use the Fern Editor**: Make edits to your docs from the browser - **Send Authenticated Preview Links** Only authenticated users can view [preview links](/learn/docs/preview-publish/previewing-changes-locally) ## How it works diff --git a/fern/products/docs/pages/component-library/writing-content/visual-editor.avif b/fern/products/docs/pages/component-library/writing-content/visual-editor.avif new file mode 100644 index 00000000..06a914e3 Binary files /dev/null and b/fern/products/docs/pages/component-library/writing-content/visual-editor.avif differ diff --git a/fern/products/docs/pages/component-library/writing-content/visual-editor.mdx b/fern/products/docs/pages/component-library/writing-content/visual-editor.mdx index 0b716829..1bf6a292 100644 --- a/fern/products/docs/pages/component-library/writing-content/visual-editor.mdx +++ b/fern/products/docs/pages/component-library/writing-content/visual-editor.mdx @@ -1,86 +1,115 @@ --- -title: Visual Editor -description: Edit your docs visually, no code required +title: Fern Editor +description: Update your docs visually with a GitHub-backed workflow that creates PRs. +slug: /docs/content/fern-editor --- - -The Visual Editor is in development. Interested in early access? Reach out via Slack or support@buildwithfern.com. - - -The Fern Visual Editor lets you modify your documentation without touching code. Make changes directly in your browser while maintaining your Git-based workflow. +Fern Editor lets you modify your documentation without touching code. Make changes directly in your browser while maintaining your Git-based workflow. - + -## Key Features - -### No-Code Editing -Edit your documentation directly in the browser - no GitHub knowledge required. Every change you make is automatically synced. - -### Component Library -You can directly edit or use the slash (`/`) menu to add Fern components to your documentation. - - - - - - [Tabs](/learn/docs/content/components/tabs) for organizing related content - - [Accordion](/learn/docs/content/components/accordions) for expandable sections - - [AccordionGroup](/learn/docs/content/components/accordion-groups) for grouped expandable content - - [Card](/learn/docs/content/components/cards) for highlighting information - - [Frame](/learn/docs/content/components/frames) for images and examples - - [Steps](/learn/docs/content/components/steps) for sequential instructions - - - - - - - [Note](/learn/docs/content/components/callouts) for important callouts - - [Warning](/learn/docs/content/components/callouts) for critical information - - [Tip](/learn/docs/content/components/callouts) for helpful suggestions - - [Info](/learn/docs/content/components/callouts) for additional context - - [Code Groups](/learn/docs/content/components/code-blocks) for related code examples - - [Code Blocks](/learn/docs/content/components/code-blocks) for code snippets - - [Embed](/learn/docs/content/components/embed) for external content - - - - - - - [Parameter Fields](/learn/docs/content/components/paramfield) for parameter details - - [Endpoint Request Snippet](/learn/docs/content/components/request-snippet) for request documentation - - [Endpoint Response Snippet](/learn/docs/content/components/response-snippet) for response documentation - - - - -## Getting Started - - - - Navigate to your Fern Dashboard (_coming soon_) and click the "Edit docs site" button in the top navigation bar. - + + ## Try it now + + + +## Key features + + + + Edit Fern Docs from an intuitive Notion-style interface + + + + Create and edit Callouts, Cards, etc directly from UI, with more components coming soon ✨ + + + + Seamlessly push changes up to GitHub for review and publishing + + + + Fully customize your site's source code from the editor when you need a little more control + + + + Drag & drop to upload media to your site, with full support for git-backed files coming soon + + + + Create/delete new pages from the editor, with more features for organizing the navigation structure of your site coming soon + + + + +Have feedback? Use the Feedback button in the top-right of the editor. + + +## FAQ + + + +
- - - Select text to format it or add links - - Use the `/` menu to add Fern components - - Preview your changes in real-time - - Add images and media - + | Component | Support Status | + | --- | --- | + | [Accordions](/learn/docs/content/components/accordions) | Supported | + | [Accordion Groups](/learn/docs/content/components/accordion-groups) | Supported | + | [Aside](/learn/docs/content/components/aside) | Coming soon | + | [Button](/learn/docs/content/components/button) | Coming soon | + | [Callouts](/learn/docs/content/components/callouts) | Supported | + | [Cards](/learn/docs/content/components/cards) | Supported | + | [Card Groups](/learn/docs/content/components/card-groups) | Supported | + | [Code Blocks](/learn/docs/content/components/code-blocks) | Supported | + | [Embed](/learn/docs/content/components/embed) | Coming soon | + | [Endpoint Request Snippet](/learn/docs/content/components/request-snippet) | Coming soon | + | [Endpoint Response Snippet](/learn/docs/content/components/response-snippet) | Coming soon | + | [Endpoint Schema Snippet](/learn/docs/content/components/schema-snippet) | Coming soon | + | [Frames](/learn/docs/content/components/frames) | Coming soon | + | [Icons](/learn/docs/content/components/icons) | Coming soon | + | [Parameter Fields](/learn/docs/content/components/parameter-fields) | Supported | + | [Steps](/learn/docs/content/components/steps) | Supported | + | [Sticky tables](/learn/docs/content/components/sticky-tables) | Coming soon | + | [Tabs](/learn/docs/content/components/tabs) | Supported | + | [Sticky tables](/learn/docs/content/components/sticky-tables) | Coming soon | + | [Tooltips](/learn/docs/content/components/tooltips) | Coming soon | - - Your changes are automatically saved as drafts. When ready: - 1. Review your changes - 2. Add a description of your updates - 3. Click "Publish" to create a pull request in Github - - - - -All changes go through your normal GitHub workflow - maintaining your team's review process while making editing accessible to everyone. - - -Ready to get started? Reach out to support@buildwithfern.com. +
+ + + + “WYSIWYG” is a common term for visual editing. Fern Editor is our visual editor - same idea, clearer name. + + + + Your changes become pull requests. That means code review, auditability, CI checks, and merge control with branch protections - no surprises in production. + + + + Yes. Fern Editor supports all built‑in components. See the full list here: [components overview](https://buildwithfern.com/learn/docs/writing-content/components/overview). + + + + Yes. Edit directly in the browser - no local environment required. Your GitHub PR keeps your normal review and CI process. + + + + Log in to the [Dashboard](https://dashboard.buildwithfern.com/), connect GitHub, then open Fern Editor from the top navigation. + + + + Yes. Pages are server‑rendered and optimized for SEO. Components within accordions and tabs are still indexable. + + + + Modern Chromium, Firefox, and Safari on desktop. Mobile editing is not yet supported. + + + diff --git a/fern/products/docs/pages/getting-started/how-it-works.mdx b/fern/products/docs/pages/getting-started/how-it-works.mdx index 200a1b47..28bc5bff 100644 --- a/fern/products/docs/pages/getting-started/how-it-works.mdx +++ b/fern/products/docs/pages/getting-started/how-it-works.mdx @@ -78,7 +78,7 @@ flowchart TD You can update your documentation in two ways: - **Direct editing**: Open a pull request directly in the [GitHub repository that contains your docs](/learn/docs/getting-started/project-structure) (including your `docs.yml` configuration and Markdown files). -- **Visual Editor**: Use Fern's [Visual Editor](/learn/docs/writing-content/visual-editor) to modify your docs without touching code. The Fern GitHub App fetches the current state from your docs repository and passes it to the Visual Editor. When you submit changes, the Fern GitHub App automatically opens a pull request for review. +- **Fern Editor**: Use the [Fern Editor](/learn/docs/writing-content/visual-editor) to modify your docs without touching code. The Fern GitHub App fetches the current state from your docs repository and passes it to the Fern Editor. When you submit changes, the Fern GitHub App automatically opens a pull request for review. After the update goes through your review process, an approver can merge it. @@ -116,19 +116,19 @@ This diagram shows how content flows from editing to deployment. ```mermaid flowchart TD - FVE[Fern Visual Editor] + FE[Fern Editor] U[User] DR[Docs Repo] CLI[Fern CLI] - Decision{Make a PR or edit in Visual Editor?} + Decision{Make a PR or edit in Fern Editor?} Spec((API Spec Repo)) GA[GitHub Actions] U ==> Decision - Decision == Make edit ==> FVE + Decision == Make edit ==> FE Decision == Open and Merge PR ==> DR - FVE <== Fetches state and opens PR ==> DR + FE <== Fetches state and opens PR ==> DR DR == ① Merged PR triggers deployment flow ==> GA Spec <-. ② Fetches and merges API spec .-> GA diff --git a/fern/products/docs/pages/getting-started/overview.mdx b/fern/products/docs/pages/getting-started/overview.mdx index 30ead9ab..bb0f48e3 100644 --- a/fern/products/docs/pages/getting-started/overview.mdx +++ b/fern/products/docs/pages/getting-started/overview.mdx @@ -72,11 +72,11 @@ subtitle: A website builder for beautiful agent and developer-friendly docs.
- Visual Editor - + Fern Editor +
- Visual Editor + Fern Editor Arrow right light Arrow right light
@@ -89,8 +89,8 @@ subtitle: A website builder for beautiful agent and developer-friendly docs.
- Visual Editor - + API Specs +
Bring your own API Spec @@ -106,8 +106,8 @@ subtitle: A website builder for beautiful agent and developer-friendly docs.
- Visual Editor - + Ask Fern +
Ask Fern diff --git a/fern/products/home/pages/images/swift-logo.svg b/fern/products/home/pages/images/swift-logo.svg new file mode 100644 index 00000000..6628633b --- /dev/null +++ b/fern/products/home/pages/images/swift-logo.svg @@ -0,0 +1,11 @@ + + + + + + + + + + + diff --git a/fern/products/home/pages/welcome.mdx b/fern/products/home/pages/welcome.mdx index 527d670e..fb7100ef 100644 --- a/fern/products/home/pages/welcome.mdx +++ b/fern/products/home/pages/welcome.mdx @@ -80,6 +80,9 @@ import { FernFooter } from "../../../components/FernFooter"; Ruby + + Swift +
{/* Action Buttons */} @@ -292,6 +295,10 @@ import { FernFooter } from "../../../components/FernFooter"; Ruby + {/* Swift */} + + Swift +
diff --git a/fern/products/sdks/introduction.mdx b/fern/products/sdks/introduction.mdx index 73ce1936..18ea668b 100644 --- a/fern/products/sdks/introduction.mdx +++ b/fern/products/sdks/introduction.mdx @@ -190,7 +190,7 @@ description: Generate idiomatic SDKs in multiple programming languages
- +
Request Swift