Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 12 additions & 4 deletions fern/products/docs/pages/ai/writer.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,10 +3,18 @@ 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.

## How it works

Fern Writer is powered by [Devin from Cognition](https://cognition.ai/blog/introducing-devin) and configured specifically for Fern documentation.

Fern Writer understands your `docs.yml` structure and navigation patterns, and knows when to use components like `<Callout>`, `<Accordion>`, and `<Tabs>`. It follows Fern's documentation standards: concise developer-focused content, specific technical language over marketing phrases, and flat information architecture.

Add an `AGENTS.md` file to your repository to extend these defaults with your own guidelines.

### 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.

Fern Writer supports image and file attachments for additional context. When tagged in an existing thread, it reads the full conversation to understand context before responding.
Expand Down Expand Up @@ -38,7 +46,7 @@ Request changes by commenting in the Slack thread or directly on the PR. Fern Wr

## Setup

To start using Fern Writer, add it to your Slack workspace (you must be a Slack admin) and invite it to channels where your team discusses documentation.
To start using Fern Writer, add it to your Slack workspace and invite it to channels where your team discusses documentation. You must be a Slack admin to install.

<Steps>
<Step title="Get your unique install link">
Expand All @@ -47,13 +55,12 @@ To start using Fern Writer, add it to your Slack workspace (you must be a Slack
- Your [Fern token](/learn/cli-api-reference/cli-reference/commands#fern-token)
- The GitHub repository containing your documentation in `owner/repo` format (e.g., `acme/docs`). The [Fern GitHub App](https://github.com/apps/fern-api) must be installed in the repository.

You can alternatively use this cURL request:
Or use this cURL request:
```bash
curl -G https://fai.buildwithfern.com/scribe/slack/get-install \
-H "Authorization: Bearer <YOUR_FERN_TOKEN>" \
--data-urlencode github_repo=<OWNER/REPO>
```

Follow the URL returned in the response.

</Step>
Expand All @@ -67,3 +74,4 @@ Once installed, add Fern Writer to Slack channels where your team discusses docu

</Step>
</Steps>