From ee9eb38e7a70cb9c46bc80137ad574c50ccb400f Mon Sep 17 00:00:00 2001 From: "fern-api[bot]" <115122769+fern-api[bot]@users.noreply.github.com> Date: Fri, 13 Mar 2026 18:31:13 +0000 Subject: [PATCH 1/3] Add GitHub and GitLab setup details to Fern Editor page --- .../writing-content/visual-editor.mdx | 20 ++++++++++++++++++- 1 file changed, 19 insertions(+), 1 deletion(-) 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 0ba0bfd19..67e14212f 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 @@ -41,9 +41,27 @@ Fern Editor lets team members such as content writers, product managers, and mar +## Connect a Git provider + +### GitHub + +GitHub is automatically connected when you install the [Fern GitHub app](https://github.com/apps/fern-api). No additional setup is required. + +### GitLab + +GitLab requires manual setup. To connect a GitLab repository: + +1. Create a GitLab [personal access token](https://docs.gitlab.com/user/profile/personal_access_tokens/) with the following scopes: `read_user`, `api`, `write_repository`, `read_repository`, `read_api`. +2. [Contact Fern support](mailto:support@buildwithfern.com) and provide your access token along with your GitLab organization name. +3. Once Fern configures the connection, add your GitLab repository in the [Dashboard](https://dashboard.buildwithfern.com/). + + +Private GitHub and GitLab instances are also supported. [Contact support](mailto:support@buildwithfern.com) to set up. + + ## Getting started -Log in to the [Dashboard](https://dashboard.buildwithfern.com/), connect your GitHub repository, and open Fern Editor from the top navigation. +Log in to the [Dashboard](https://dashboard.buildwithfern.com/), connect your repository, and open Fern Editor from the top navigation. See [Connect a Git provider](#connect-a-git-provider) for setup details. From the Editor you can drag and drop media, create and delete pages, update branding (logo, favicon, title), and switch to dev mode for source code editing. From 47df95381816ff196bc9d4b1a0e710055bd2346c Mon Sep 17 00:00:00 2001 From: "fern-api[bot]" <115122769+fern-api[bot]@users.noreply.github.com> Date: Fri, 13 Mar 2026 18:33:58 +0000 Subject: [PATCH 2/3] Add Git and GitLab to Vale heading exceptions --- .vale/styles/FernStyles/Headings.yml | 2 ++ 1 file changed, 2 insertions(+) diff --git a/.vale/styles/FernStyles/Headings.yml b/.vale/styles/FernStyles/Headings.yml index 8ff404f6e..a22807193 100644 --- a/.vale/styles/FernStyles/Headings.yml +++ b/.vale/styles/FernStyles/Headings.yml @@ -33,7 +33,9 @@ exceptions: - SDKs - API Reference - API Explorer + - Git - GitHub + - GitLab - README - Action - Actions From 73aca797ed1297e1c324ba7919be55af8224934d Mon Sep 17 00:00:00 2001 From: Devin Logan Date: Fri, 13 Mar 2026 14:49:39 -0400 Subject: [PATCH 3/3] finetune instructions --- .../writing-content/visual-editor.mdx | 43 ++++++++++--------- 1 file changed, 23 insertions(+), 20 deletions(-) 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 67e14212f..0aa4a2e8d 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 @@ -23,7 +23,7 @@ Fern Editor lets team members such as content writers, product managers, and mar ## Key features - + Create and edit Callouts, Cards, Accordions, Code Blocks, and other Fern components from the UI @@ -35,37 +35,40 @@ Fern Editor lets team members such as content writers, product managers, and mar Multiple team members can edit the same PR in the Editor without GitHub access - - - Supports private GitHub and GitLab instances. [Contact support](mailto:support@buildwithfern.com) to set up. - -## Connect a Git provider +## Getting started -### GitHub + -GitHub is automatically connected when you install the [Fern GitHub app](https://github.com/apps/fern-api). No additional setup is required. +### Connect a Git provider -### GitLab + +Private GitHub and GitLab instances are supported. [Contact support](mailto:support@buildwithfern.com) to set up. + -GitLab requires manual setup. To connect a GitLab repository: + + +Install the [Fern GitHub app](https://github.com/apps/fern-api), then [connect your repository](/learn/dashboard/configuration/github-repo) in the [Dashboard](https://dashboard.buildwithfern.com/). + + +GitLab requires manual setup: -1. Create a GitLab [personal access token](https://docs.gitlab.com/user/profile/personal_access_tokens/) with the following scopes: `read_user`, `api`, `write_repository`, `read_repository`, `read_api`. -2. [Contact Fern support](mailto:support@buildwithfern.com) and provide your access token along with your GitLab organization name. -3. Once Fern configures the connection, add your GitLab repository in the [Dashboard](https://dashboard.buildwithfern.com/). +1. [Create a personal access token](https://gitlab.com/-/user_settings/personal_access_tokens) in GitLab with the following scopes: `api`, `read_repository`, `write_repository`. Set the expiration date far into the future to avoid disrupting your Editor experience — you can revoke the token at any time. +2. Contact Fern support via Slack or [email](mailto:support@buildwithfern.com) with your access token and GitLab repository URL. +3. Once Fern configures the connection, [connect your repository](/learn/dashboard/configuration/github-repo) in the [Dashboard](https://dashboard.buildwithfern.com/). + + - -Private GitHub and GitLab instances are also supported. [Contact support](mailto:support@buildwithfern.com) to set up. - +### Set up permissions -## Getting started +Configure [member permissions](/learn/dashboard/configuration/permissions) for your organization to control who can use Fern Editor. Admins and Editors can make changes; Viewers have read-only access. -Log in to the [Dashboard](https://dashboard.buildwithfern.com/), connect your repository, and open Fern Editor from the top navigation. See [Connect a Git provider](#connect-a-git-provider) for setup details. +### Open the Editor -From the Editor you can drag and drop media, create and delete pages, update branding (logo, favicon, title), and switch to dev mode for source code editing. +Log in to the [Dashboard](https://dashboard.buildwithfern.com/) and open Fern Editor from the **Overview** tab. From here you can drag and drop media, create and delete pages, update branding (logo, favicon, title), and switch to dev mode for source code editing. -To manage access, see [Member permissions](/learn/dashboard/configuration/permissions). Admins and Editors can use the Editor; Viewers have read-only access. + Fern Editor supports modern Chromium browsers on desktop. Mobile editing and support for other browsers are coming soon.