From 31d111176747dc6209dc539392387c178b6329ec Mon Sep 17 00:00:00 2001 From: eden Date: Wed, 17 Dec 2025 11:02:45 -0500 Subject: [PATCH 1/5] Add context on why Fern Writer is useful. --- fern/products/docs/pages/ai/writer.mdx | 2 ++ 1 file changed, 2 insertions(+) diff --git a/fern/products/docs/pages/ai/writer.mdx b/fern/products/docs/pages/ai/writer.mdx index 87a24b8b9..8bd04f015 100644 --- a/fern/products/docs/pages/ai/writer.mdx +++ b/fern/products/docs/pages/ai/writer.mdx @@ -5,6 +5,8 @@ description: A Slack-based technical writing agent that updates your documentati Fern Writer is a Slack-based technical writing agent that keeps your docs aligned as your product evolves. It's powered by [Devin from Cognition](https://cognition.ai/blog/introducing-devin). Fern Writer understands Fern components and your writing style, and can be customized via an `AGENTS.md` file in your docs repository. +Fern Writer is instructed to follow standard Fern documentation standards and adheres to technical writing best practices. + ## How it works In Slack channels where you've added Fern Writer, tag `@Fern Writer` and describe the change you need. Fern Writer only responds when directly tagged. It will react to your message to confirm receipt, then create a pull request and reply with a link. From 1eae21ff4cf0d7800162658751a73879ca051ea1 Mon Sep 17 00:00:00 2001 From: eden Date: Wed, 17 Dec 2025 11:05:45 -0500 Subject: [PATCH 2/5] update --- fern/products/docs/pages/ai/writer.mdx | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/fern/products/docs/pages/ai/writer.mdx b/fern/products/docs/pages/ai/writer.mdx index 8bd04f015..65a6b0732 100644 --- a/fern/products/docs/pages/ai/writer.mdx +++ b/fern/products/docs/pages/ai/writer.mdx @@ -3,9 +3,7 @@ title: Fern Writer description: A Slack-based technical writing agent that updates your documentation via GitHub pull requests --- -Fern Writer is a Slack-based technical writing agent that keeps your docs aligned as your product evolves. It's powered by [Devin from Cognition](https://cognition.ai/blog/introducing-devin). Fern Writer understands Fern components and your writing style, and can be customized via an `AGENTS.md` file in your docs repository. - -Fern Writer is instructed to follow standard Fern documentation standards and adheres to technical writing best practices. +Fern Writer is a Slack-based technical writing agent that keeps your docs aligned as your product evolves. It's powered by [Devin from Cognition](https://cognition.ai/blog/introducing-devin). Fern Writer understands Fern components and your writing style, and can be customized via an `AGENTS.md` file in your docs repository. Fern Writer will always follow technical writing best practices and apply them to your documentation. ## How it works From 172100c01c55cb66fd8a6de70a4db7a14dd22a09 Mon Sep 17 00:00:00 2001 From: eden Date: Wed, 17 Dec 2025 12:30:28 -0500 Subject: [PATCH 3/5] Add Why Fern Writer section --- fern/products/docs/pages/ai/writer.mdx | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/fern/products/docs/pages/ai/writer.mdx b/fern/products/docs/pages/ai/writer.mdx index 65a6b0732..4084e2026 100644 --- a/fern/products/docs/pages/ai/writer.mdx +++ b/fern/products/docs/pages/ai/writer.mdx @@ -3,7 +3,17 @@ title: Fern Writer description: A Slack-based technical writing agent that updates your documentation via GitHub pull requests --- -Fern Writer is a Slack-based technical writing agent that keeps your docs aligned as your product evolves. It's powered by [Devin from Cognition](https://cognition.ai/blog/introducing-devin). Fern Writer understands Fern components and your writing style, and can be customized via an `AGENTS.md` file in your docs repository. Fern Writer will always follow technical writing best practices and apply them to your documentation. +Fern Writer is a Slack-based technical writing agent that keeps your docs aligned as your product evolves. It's powered by [Devin from Cognition](https://cognition.ai/blog/introducing-devin). Fern Writer understands Fern components and your writing style, and can be customized via an `AGENTS.md` file in your docs repository. + +## Why Fern Writer? + +While Fern Writer is powered by Devin, it's specifically trained and optimized for technical documentation: + +- **Deep Fern knowledge**: Understands `docs.yml` structure, navigation patterns, and how to organize content across your documentation site +- **Fern components by default**: Knows when to use ``, ``, ``, ``, and other Fern components to create rich, interactive documentation +- **Your technical writer**: Follows technical writing best practices and can be customized to match your team's style guide via `AGENTS.md`. Perfect for small teams without a dedicated technical writer + +Fern Writer isn't just a coding agent that edits markdown—it's an AI technical writer that understands how to create clear, well-structured documentation that matches your existing voice and leverages the full power of Fern's component library. ## How it works From ff3e9f046cdacd10d1b50b68123a8a1557519c58 Mon Sep 17 00:00:00 2001 From: Devin Logan Date: Wed, 17 Dec 2025 17:13:40 -0500 Subject: [PATCH 4/5] add more info on fern writer --- fern/products/docs/pages/ai/writer.mdx | 22 ++++++++++------------ 1 file changed, 10 insertions(+), 12 deletions(-) diff --git a/fern/products/docs/pages/ai/writer.mdx b/fern/products/docs/pages/ai/writer.mdx index 4084e2026..232469382 100644 --- a/fern/products/docs/pages/ai/writer.mdx +++ b/fern/products/docs/pages/ai/writer.mdx @@ -3,19 +3,17 @@ title: Fern Writer description: A Slack-based technical writing agent that updates your documentation via GitHub pull requests --- -Fern Writer is a Slack-based technical writing agent that keeps your docs aligned as your product evolves. It's powered by [Devin from Cognition](https://cognition.ai/blog/introducing-devin). Fern Writer understands Fern components and your writing style, and can be customized via an `AGENTS.md` file in your docs repository. +Fern Writer is a Slack-based technical writing agent that keeps your docs aligned as your product evolves. Request documentation updates in the Slack channels where your team already discusses changes. No context-switching or detailed prompts required. -## Why Fern Writer? +## How it works -While Fern Writer is powered by Devin, it's specifically trained and optimized for technical documentation: +Fern Writer is powered by [Devin from Cognition](https://cognition.ai/blog/introducing-devin) and configured specifically for Fern documentation. -- **Deep Fern knowledge**: Understands `docs.yml` structure, navigation patterns, and how to organize content across your documentation site -- **Fern components by default**: Knows when to use ``, ``, ``, ``, and other Fern components to create rich, interactive documentation -- **Your technical writer**: Follows technical writing best practices and can be customized to match your team's style guide via `AGENTS.md`. Perfect for small teams without a dedicated technical writer +Fern Writer understands your `docs.yml` structure and navigation patterns, and knows when to use components like ``, ``, and ``. It follows Fern's documentation standards: concise developer-focused content, specific technical language over marketing phrases, and flat information architecture. -Fern Writer isn't just a coding agent that edits markdown—it's an AI technical writer that understands how to create clear, well-structured documentation that matches your existing voice and leverages the full power of Fern's component library. +Add an `AGENTS.md` file to your repository to extend these defaults with your own guidelines. -## How it works +### Slack workflow In Slack channels where you've added Fern Writer, tag `@Fern Writer` and describe the change you need. Fern Writer only responds when directly tagged. It will react to your message to confirm receipt, then create a pull request and reply with a link. @@ -36,7 +34,7 @@ Request changes by commenting in the Slack thread or directly on the PR. Fern Wr