From dd5ff1d672baebecbb233713adb2f654494750f4 Mon Sep 17 00:00:00 2001 From: "devin.logan" Date: Wed, 2 Sep 2026 16:48:23 +0000 Subject: [PATCH 1/5] docs: add hidden technical evaluation page Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> --- fern/products/docs/docs.yml | 3 ++ .../getting-started/technical-evaluation.mdx | 50 +++++++++++++++++++ 2 files changed, 53 insertions(+) create mode 100644 fern/products/docs/pages/getting-started/technical-evaluation.mdx diff --git a/fern/products/docs/docs.yml b/fern/products/docs/docs.yml index e7a1bcf201..50a68f5b20 100644 --- a/fern/products/docs/docs.yml +++ b/fern/products/docs/docs.yml @@ -10,6 +10,9 @@ navigation: - page: Self-service setup path: ./pages/getting-started/self-service-setup.mdx hidden: true + - page: Technical evaluation + path: ./pages/getting-started/technical-evaluation.mdx + hidden: true - page: Project structure path: ./pages/getting-started/project-structure.mdx - link: Customer showcase diff --git a/fern/products/docs/pages/getting-started/technical-evaluation.mdx b/fern/products/docs/pages/getting-started/technical-evaluation.mdx new file mode 100644 index 0000000000..77a99cfe5c --- /dev/null +++ b/fern/products/docs/pages/getting-started/technical-evaluation.mdx @@ -0,0 +1,50 @@ +--- +title: Technical evaluation +description: How a technical evaluation with the Fern team works, from the demo site through requirements review and approvals. +--- + + +A technical evaluation is a guided trial of Fern using your own content. It takes one to three weeks, giving your team time to publish real changes and see what Fern and Fern's outputs look and feel like before you commit. + +Your Fern account team runs the evaluation with you. Contact them with questions at any point during the process. + +## Evaluation stages + +| Stage | Outcome | +| --- | --- | +| 1. Demo site | Fern stands up a site with representative content, specs, and configuration. | +| 2. Hands-on access | Your whole team can edit and publish docs directly. | +| 3. Requirements sheet | A shared, prioritized list of what your docs need. | +| 4. Requirements review | Fern matches the demo to the sheet and walks through it on a call. | +| 5. Stakeholder sessions | Each team sees how Fern fits their workflow. | +| 6. Approvals | Legal, security, and procurement reviews. | + +## Demo site + +Fern builds the demo site before the evaluation starts, using representative content from your existing docs, your API specs, and configuration close to what you would ship. Send further configuration requests to your account team: versions, products, branding, authentication, or anything else the demo needs to represent your real site. + +## Hands-on access + +Fern gives every participant access to the demo site so your team can go through the publishing flow rather than watch it. Both authoring paths are available: + +- Writers who don't use Git can edit and publish in [Fern Editor](/learn/docs/writing-content/fern-editor). +- Engineers and writers who prefer Git can clone the repository and work locally. The [Docs quickstart](/learn/docs/getting-started/quickstart) covers the CLI, local previews, and publishing. + +## Requirements sheet + +Fern and your team build a shared requirements document, with each requirement prioritized as a must-have, should-have, or could-have. Fern then configures the demo site to match the sheet and presents it on a call, going through the requirements one by one so each is either checked off or has a clear path forward. + +## Stakeholder sessions + +Fern meets with each team that touches your docs to discuss how Fern fits their existing flows and the outcomes they care about. + +| Team | Topics | +| --- | --- | +| Engineering | [Spec syncing](/learn/api-definitions/openapi/sync-your-open-api-specification), [API Explorer](/learn/docs/api-references/api-explorer) configuration with [SDK snippets](/learn/docs/api-references/sdk-snippets) and [API key injection](/learn/docs/authentication/features/api-key-injection), and how Fern reduces time to first API call. | +| Marketing | The [SEO, GEO](/learn/docs/seo/overview), and agentic optimizations Fern provides to improve discoverability by both agents and humans. | +| Support | Configuring [Ask Fern](/learn/docs/ai-features/ask-fern/overview) as the first line of support for your users. | +| Technical writing | Automating docs maintenance with the [Fern Agent](/learn/docs/ai-features/fern-agent), driven by code changes, [user feedback](/learn/docs/customization/user-feedback), support tickets, and [analytics](/learn/docs/integrations/overview). | + +## Approvals + +Once the requirements are settled, Fern works with your legal, security, and procurement teams through their review processes. The [security overview](/learn/docs/security/overview) covers Fern's architecture, authentication model, and self-hosted options, which are the most common questions in a security review. From 8363a318019178f0572e60c0d7666c16eac11f92 Mon Sep 17 00:00:00 2001 From: Devin Logan Date: Wed, 2 Sep 2026 13:28:05 -0400 Subject: [PATCH 2/5] updates --- .../pages/getting-started/technical-evaluation.mdx | 13 +++++++------ 1 file changed, 7 insertions(+), 6 deletions(-) diff --git a/fern/products/docs/pages/getting-started/technical-evaluation.mdx b/fern/products/docs/pages/getting-started/technical-evaluation.mdx index 77a99cfe5c..d8bcc86e25 100644 --- a/fern/products/docs/pages/getting-started/technical-evaluation.mdx +++ b/fern/products/docs/pages/getting-started/technical-evaluation.mdx @@ -3,8 +3,9 @@ title: Technical evaluation description: How a technical evaluation with the Fern team works, from the demo site through requirements review and approvals. --- + -A technical evaluation is a guided trial of Fern using your own content. It takes one to three weeks, giving your team time to publish real changes and see what Fern and Fern's outputs look and feel like before you commit. +A technical evaluation is a guided trial of [Fern](/learn/docs/getting-started/capabilities) using your own content. It takes one to three weeks, giving your team time to publish real changes and see what Fern's outputs look and feel like before you commit. Your Fern account team runs the evaluation with you. Contact them with questions at any point during the process. @@ -21,18 +22,18 @@ Your Fern account team runs the evaluation with you. Contact them with questions ## Demo site -Fern builds the demo site before the evaluation starts, using representative content from your existing docs, your API specs, and configuration close to what you would ship. Send further configuration requests to your account team: versions, products, branding, authentication, or anything else the demo needs to represent your real site. +Fern builds the demo site before the evaluation starts, using representative content from your existing docs, your API specs, and configuration close to what you would ship. Send your account team a content export, your API specs, and brand assets like your logo, favicon, colors, and fonts so the demo starts as close to your real site as possible. Send further configuration requests as they come up: versions, products, additional branding, authentication, or anything else the demo needs to represent your real site. ## Hands-on access Fern gives every participant access to the demo site so your team can go through the publishing flow rather than watch it. Both authoring paths are available: - Writers who don't use Git can edit and publish in [Fern Editor](/learn/docs/writing-content/fern-editor). -- Engineers and writers who prefer Git can clone the repository and work locally. The [Docs quickstart](/learn/docs/getting-started/quickstart) covers the CLI, local previews, and publishing. +- Engineers and writers who prefer Git can clone the repository and work locally against Fern's [project structure](/learn/docs/getting-started/project-structure). The [Docs quickstart](/learn/docs/getting-started/quickstart) covers the CLI, local previews, and publishing. ## Requirements sheet -Fern and your team build a shared requirements document, with each requirement prioritized as a must-have, should-have, or could-have. Fern then configures the demo site to match the sheet and presents it on a call, going through the requirements one by one so each is either checked off or has a clear path forward. +Fern and your team build a shared requirements document, with each requirement prioritized as a must-have, should-have, or could-have. Alongside the requirements, agree on two or three success criteria tied to an outcome you care about, like reader activation, support ticket deflection, or engineering time saved on docs maintenance, so the evaluation has a clear bar to clear rather than just a feature list. Fern then configures the demo site to match the sheet and presents it on a call, going through the requirements one by one so each is either checked off or has a clear path forward. ## Stakeholder sessions @@ -40,8 +41,8 @@ Fern meets with each team that touches your docs to discuss how Fern fits their | Team | Topics | | --- | --- | -| Engineering | [Spec syncing](/learn/api-definitions/openapi/sync-your-open-api-specification), [API Explorer](/learn/docs/api-references/api-explorer) configuration with [SDK snippets](/learn/docs/api-references/sdk-snippets) and [API key injection](/learn/docs/authentication/features/api-key-injection), and how Fern reduces time to first API call. | -| Marketing | The [SEO, GEO](/learn/docs/seo/overview), and agentic optimizations Fern provides to improve discoverability by both agents and humans. | +| Engineering | [Spec syncing](/learn/api-definitions/openapi/sync-your-open-api-specification), [API Explorer](/learn/docs/api-references/api-explorer) configuration with [SDK snippets](/learn/docs/api-references/sdk-snippets) and [API key injection](/learn/docs/authentication/features/api-key-injection), and how Fern [reduces time to first API call](https://buildwithfern.com/customers/frame). | +| Marketing | The [SEO, GEO](/learn/docs/seo/overview), and [agentic optimizations](/learn/docs/ai-features/overview) Fern provides to improve discoverability by both agents and humans. | | Support | Configuring [Ask Fern](/learn/docs/ai-features/ask-fern/overview) as the first line of support for your users. | | Technical writing | Automating docs maintenance with the [Fern Agent](/learn/docs/ai-features/fern-agent), driven by code changes, [user feedback](/learn/docs/customization/user-feedback), support tickets, and [analytics](/learn/docs/integrations/overview). | From 8f70f632a9cd4934c7e1234cfec5f4ad6a3a11d8 Mon Sep 17 00:00:00 2001 From: Devin Logan Date: Wed, 2 Sep 2026 13:30:49 -0400 Subject: [PATCH 3/5] break up big paragraphs --- .../getting-started/technical-evaluation.mdx | 16 ++++++++++++++-- 1 file changed, 14 insertions(+), 2 deletions(-) diff --git a/fern/products/docs/pages/getting-started/technical-evaluation.mdx b/fern/products/docs/pages/getting-started/technical-evaluation.mdx index d8bcc86e25..4166afdabe 100644 --- a/fern/products/docs/pages/getting-started/technical-evaluation.mdx +++ b/fern/products/docs/pages/getting-started/technical-evaluation.mdx @@ -22,7 +22,15 @@ Your Fern account team runs the evaluation with you. Contact them with questions ## Demo site -Fern builds the demo site before the evaluation starts, using representative content from your existing docs, your API specs, and configuration close to what you would ship. Send your account team a content export, your API specs, and brand assets like your logo, favicon, colors, and fonts so the demo starts as close to your real site as possible. Send further configuration requests as they come up: versions, products, additional branding, authentication, or anything else the demo needs to represent your real site. +Fern builds the demo site before the evaluation starts, using representative content from your existing docs, your API specs, and configuration close to what you would ship. + +To get the demo as close to your real site as possible, send your account team: + +- A content export from your existing docs +- Your API specs +- Brand assets like your logo, favicon, colors, and fonts + +Send further configuration requests as they come up: versions, products, additional branding, authentication, or anything else the demo needs to represent your real site. ## Hands-on access @@ -33,7 +41,11 @@ Fern gives every participant access to the demo site so your team can go through ## Requirements sheet -Fern and your team build a shared requirements document, with each requirement prioritized as a must-have, should-have, or could-have. Alongside the requirements, agree on two or three success criteria tied to an outcome you care about, like reader activation, support ticket deflection, or engineering time saved on docs maintenance, so the evaluation has a clear bar to clear rather than just a feature list. Fern then configures the demo site to match the sheet and presents it on a call, going through the requirements one by one so each is either checked off or has a clear path forward. +Fern and your team build a shared requirements document, with each requirement prioritized as a must-have, should-have, or could-have. + +Alongside the requirements, agree on two or three success criteria tied to an outcome you care about, like reader activation, support ticket deflection, or engineering time saved on docs maintenance. That gives the evaluation a clear bar to clear rather than just a feature list. + +Fern then configures the demo site to match the sheet and presents it on a call, going through the requirements one by one so each is either checked off or has a clear path forward. ## Stakeholder sessions From 74b2000bf640dd68bf6c4c2c667bc92e81fe637e Mon Sep 17 00:00:00 2001 From: Devin Logan Date: Wed, 2 Sep 2026 13:36:47 -0400 Subject: [PATCH 4/5] add anchors --- .../pages/getting-started/technical-evaluation.mdx | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/fern/products/docs/pages/getting-started/technical-evaluation.mdx b/fern/products/docs/pages/getting-started/technical-evaluation.mdx index 4166afdabe..6b27066f9f 100644 --- a/fern/products/docs/pages/getting-started/technical-evaluation.mdx +++ b/fern/products/docs/pages/getting-started/technical-evaluation.mdx @@ -13,12 +13,12 @@ Your Fern account team runs the evaluation with you. Contact them with questions | Stage | Outcome | | --- | --- | -| 1. Demo site | Fern stands up a site with representative content, specs, and configuration. | -| 2. Hands-on access | Your whole team can edit and publish docs directly. | -| 3. Requirements sheet | A shared, prioritized list of what your docs need. | -| 4. Requirements review | Fern matches the demo to the sheet and walks through it on a call. | -| 5. Stakeholder sessions | Each team sees how Fern fits their workflow. | -| 6. Approvals | Legal, security, and procurement reviews. | +| 1. [Demo site](#demo-site) | Fern stands up a site with representative content, specs, and configuration. | +| 2. [Hands-on access](#hands-on-access) | Your whole team can edit and publish docs directly. | +| 3. [Requirements sheet](#requirements-sheet) | A shared, prioritized list of what your docs need. | +| 4. [Requirements review](#requirements-sheet) | Fern matches the demo to the sheet and walks through it on a call. | +| 5. [Stakeholder sessions](#stakeholder-sessions) | Each team sees how Fern fits their workflow. | +| 6. [Approvals](#approvals) | Legal, security, and procurement reviews. | ## Demo site From 603779005d8c33971bbcff62fc74dab4ffe974b9 Mon Sep 17 00:00:00 2001 From: Devin Logan Date: Wed, 2 Sep 2026 14:22:57 -0400 Subject: [PATCH 5/5] add sentence --- .../docs/pages/getting-started/technical-evaluation.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/fern/products/docs/pages/getting-started/technical-evaluation.mdx b/fern/products/docs/pages/getting-started/technical-evaluation.mdx index 6b27066f9f..2d3ee400e6 100644 --- a/fern/products/docs/pages/getting-started/technical-evaluation.mdx +++ b/fern/products/docs/pages/getting-started/technical-evaluation.mdx @@ -49,9 +49,9 @@ Fern then configures the demo site to match the sheet and presents it on a call, ## Stakeholder sessions -Fern meets with each team that touches your docs to discuss how Fern fits their existing flows and the outcomes they care about. +Fern meets with the teams that touch your docs to discuss how Fern fits their existing flows and the outcomes they care about. Which teams join and what each session covers depends on what matters to you. The table below shows common examples: -| Team | Topics | +| Example team | Example topics | | --- | --- | | Engineering | [Spec syncing](/learn/api-definitions/openapi/sync-your-open-api-specification), [API Explorer](/learn/docs/api-references/api-explorer) configuration with [SDK snippets](/learn/docs/api-references/sdk-snippets) and [API key injection](/learn/docs/authentication/features/api-key-injection), and how Fern [reduces time to first API call](https://buildwithfern.com/customers/frame). | | Marketing | The [SEO, GEO](/learn/docs/seo/overview), and [agentic optimizations](/learn/docs/ai-features/overview) Fern provides to improve discoverability by both agents and humans. |