diff --git a/fern/assets/styles.css b/fern/assets/styles.css index cd641a710..ca8c4302f 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/docs.yml b/fern/docs.yml index a94214532..219f12c5e 100644 --- a/fern/docs.yml +++ b/fern/docs.yml @@ -412,7 +412,7 @@ redirects: destination: /learn/docs/customization/changelogs permanent: true - source: /learn/docs/content/visual-editor - destination: /learn/docs/writing-content/visual-editor + destination: /learn/docs/writing-content/fern-editor permanent: true - source: /learn/docs/writing-content/code-blocks destination: /learn/docs/writing-content/components/code-blocks 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 9dc61a230..389c71126 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 92e855eaa..953ce9f4a 100644 --- a/fern/products/docs/docs.yml +++ b/fern/products/docs/docs.yml @@ -95,8 +95,9 @@ 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 + slug: fern-editor - page: Reusable snippets path: ./pages/component-library/custom-components/reusable-markdown.mdx slug: reusable-markdown diff --git a/fern/products/docs/pages/authentication/sso.mdx b/fern/products/docs/pages/authentication/sso.mdx index 6c362121c..ef3e3c9a8 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 000000000..06a914e39 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 0b716829f..6b239e0f8 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,106 @@ --- -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 pull requests. --- - -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 anyone on your team update documentation without learning code, markdown, or Git. Perfect for non-technical teammates like content writers, product managers, and marketers who want to contribute to docs without needing developer setup. - + -## 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 + + + + Write and edit like you would in Notion or Google Docs—no markdown or code required + + + + Create and edit Callouts, Cards, etc directly from UI, with more components coming soon ✨ + + + + Maintains docs-as-code approach with Git history and review process—making content easily consumable by AI tools + + + + 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 + + + +## 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. +
+ + + + "What You See Is What You Get" (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. + + + + Currently supports modern Chromium browsers on desktop only. Mobile editing and other browsers coming soon. + + + 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 200a1b47f..28bc5bff2 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 30ead9ab6..0c010c2d2 100644 --- a/fern/products/docs/pages/getting-started/overview.mdx +++ b/fern/products/docs/pages/getting-started/overview.mdx @@ -70,13 +70,13 @@ 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 000000000..6628633b8 --- /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 527d670e2..c46356dda 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 */} @@ -138,6 +141,11 @@ import { FernFooter } from "../../../components/FernFooter"; Arrow right light Arrow right light + + Fern Editor + Arrow right light + Arrow right light + Bring your own API spec Arrow right light @@ -292,6 +300,10 @@ import { FernFooter } from "../../../components/FernFooter"; Ruby + {/* Swift */} + + Swift +
diff --git a/fern/products/sdks/introduction.mdx b/fern/products/sdks/introduction.mdx index 73ce19363..18ea668b8 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