Add Fern Agent docs, rewrite Fern in Slack, and consolidate the Slack pages by fern-api[bot] · Pull Request #6624 · fern-api/docs

fern-api · 2026-08-13T17:14:49Z

Summary

Documents Fern Agent, and folds in the Fern in Slack rewrite from #6623 (now closed) so both AI surfaces land together.

Fern Agent (pages/ai/fern-agent.mdx, new): checked against fai and the dashboard agent code, so the page describes what the agent actually does — docs edits committed to a branch and handed to an editor session (with a PR on request via deliver_docs_edit), the analytics it can query (pageviews/visitors/sessions/404s, referrers, search queries, Ask Fern conversations, feedback, LLM bot traffic), site config and deployment history, and org member listing. Actions the agent can't perform (API keys, members, billing) are described as dashboard links, matching suggest_dashboard_page. The page says the feature is in beta but no longer claims an org allowlist, per the launch plan.

Fern in Slack (pages/ai/fern-slack.mdx, new; replaces ask-fern/slack-app.mdx and ai/writer.mdx): one @Fern bot with two capability categories, answering questions and updating docs, matching where the product is heading. The two installations are still separate in fai (ASK_FERN_SLACK_* vs SCRIBE_SLACK_* credentials, /slack/get-install vs /scribe/slack/get-install), so the setup steps stay per-capability without framing them as two different bots. Restores content the #6623 draft dropped but that still applies: the Slack screenshots, the writer video and PR-attribution image, the RBAC cross-link, the indexing conversation example, and the request-flow diagram. Fern Agent's own Slack surface is deliberately not documented: those endpoints are x-fern-audiences: internal.

Navigation and cross-references: Fern in Slack and Fern Agent in the AI features section; Fern Writer and Slack app entries removed; redirects added for /learn/docs/ai-features/fern-writer and /learn/docs/ai-features/ask-fern/slack-app; pointers updated on the AI features overview, capabilities, the self-hosted feature table, and the Ask Fern setup steps. The AI credits row is renamed from Fern Writer session to Docs update in Slack (still 50 credits per session).

Changelog: pages/changelog/2026-08-13.mdx for Fern Agent.

Validation

fern check --warnings: 0 errors, 6 pre-existing warnings (endpoint path conflicts, FDR 403 on the redirects check, accent-color contrast).
pre-commit (vale): 0 errors on the changed pages.

Link to Devin session: https://app.devin.ai/sessions/d5901916a19e45ceb30a7cfd47e21549

github-actions · 2026-08-13T17:15:20Z

+Ask questions about your docs traffic, reader behavior, and broken links without writing a single query.
+
+<Prompt title="Check traffic">
+Which pages got the most traffic last month?


📝 [vale] _{reported by reviewdog 🐶}
[Microsoft.QuestionMarks] Use questions sparingly.

github-actions · 2026-08-13T17:15:20Z

+<br />
+
+<Prompt title="Find broken links">
+Are there any 404s on my site?


📝 [vale] _{reported by reviewdog 🐶}
[Microsoft.QuestionMarks] Use questions sparingly.

github-actions · 2026-08-13T17:15:20Z

+<br />
+
+<Prompt title="Understand traffic sources">
+Where is my traffic coming from?


🚫 [vale] _{reported by reviewdog 🐶}
[Microsoft.Contractions] Use 'where's' instead of 'Where is'.

github-actions · 2026-08-13T17:15:20Z

+<br />
+
+<Prompt title="Understand traffic sources">
+Where is my traffic coming from?


📝 [vale] _{reported by reviewdog 🐶}
[Microsoft.QuestionMarks] Use questions sparingly.

github-actions · 2026-08-13T17:15:20Z

+Where is my traffic coming from?
+</Prompt>
+
+### Review Ask AI activity


📝 [vale] _{reported by reviewdog 🐶}
[FernStyles.Headings] 'Review Ask AI activity' should use sentence-style capitalization.

github-actions · 2026-08-13T17:15:20Z

+Get a summary of what your readers are asking [Ask Fern](/learn/docs/ai-features/ask-fern/overview), which questions went unresolved, and what topics might need better documentation coverage.
+
+<Prompt title="Summarize reader questions">
+What have readers been asking about this week?


📝 [vale] _{reported by reviewdog 🐶}
[Microsoft.QuestionMarks] Use questions sparingly.

github-actions · 2026-08-13T17:15:20Z

+<br />
+
+<Prompt title="Find unresolved conversations">
+Show me unresolved Ask AI conversations.


📝 [vale] _{reported by reviewdog 🐶}
[FernStyles.FirstPerson] Use first person (such as 'me') sparingly.

github-actions · 2026-08-13T17:15:20Z

+Ask about members, billing, API keys, and site settings. For actions that require dashboard access, Fern Agent links you directly to the right page.
+
+<Prompt title="Check organization members">
+Who are the admins in my organization?


📝 [vale] _{reported by reviewdog 🐶}
[Microsoft.QuestionMarks] Use questions sparingly.

github-actions · 2026-08-13T17:15:20Z

+<br />
+
+<Prompt title="Find API key settings">
+Where do I manage API keys?


📝 [vale] _{reported by reviewdog 🐶}
[FernStyles.FirstPerson] Use first person (such as ' I') sparingly.

github-actions · 2026-08-13T17:15:20Z

+<br />
+
+<Prompt title="Find API key settings">
+Where do I manage API keys?


📝 [vale] _{reported by reviewdog 🐶}
[Microsoft.QuestionMarks] Use questions sparingly.

github-actions · 2026-08-13T17:16:19Z

🌿 Preview your docs: https://fern-preview-2026-08-13-fern-ai-d8be69-f788c4eb.docs.buildwithfern.com/learn

Here are the markdown pages you've updated:

Beta/allowlisted availability, dashboard editor-first delivery, actual analytics and org capabilities, plus a Fern Agent card on the AI features overview. Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>

github-actions · 2026-08-13T17:34:00Z

+<Accordion title="Indexing conversation example">
+
+**User –** *@PlantSupport* what's the best way to care for succulents
+indoors?


📝 [vale] _{reported by reviewdog 🐶}
[Microsoft.QuestionMarks] Use questions sparingly.

github-actions · 2026-08-13T17:34:00Z

+
+**Support Lead –** *@PlantSupport* This is good but you should mention drainage holes and the
+risk of root rot. Also, watering frequency depends on the season - less in
+winter. Let's index this thread.


📝 [vale] _{reported by reviewdog 🐶}
[FernStyles.We] Try to avoid using first-person plural like 'Let's'.

github-actions · 2026-08-13T17:34:00Z

+risk of root rot. Also, watering frequency depends on the season - less in
+winter. Let's index this thread.
+
+**Plant Support bot:** I'd be happy to help you index this thread! Let me work


📝 [vale] _{reported by reviewdog 🐶}
[FernStyles.FirstPerson] Use first person (such as 'I'd') sparingly.

github-actions · 2026-08-13T17:34:00Z

+risk of root rot. Also, watering frequency depends on the season - less in
+winter. Let's index this thread.
+
+**Plant Support bot:** I'd be happy to help you index this thread! Let me work


📝 [vale] _{reported by reviewdog 🐶}
[Microsoft.ExclamationPoints] Use exclamation points sparingly.

github-actions · 2026-08-13T17:34:00Z

+risk of root rot. Also, watering frequency depends on the season - less in
+winter. Let's index this thread.
+
+**Plant Support bot:** I'd be happy to help you index this thread! Let me work


📝 [vale] _{reported by reviewdog 🐶}
[FernStyles.FirstPerson] Use first person (such as 'me') sparingly.

github-actions · 2026-08-13T17:34:00Z

+
+Does this capture the question and response accurately? Would you like me to adjust anything before saving it to your knowledge base?
+
+**Support Lead:** *@PlantSupport* Perfect! Please save this.


📝 [vale] _{reported by reviewdog 🐶}
[Microsoft.ExclamationPoints] Use exclamation points sparingly.

github-actions · 2026-08-13T17:34:00Z

+
+Does this capture the question and response accurately? Would you like me to adjust anything before saving it to your knowledge base?
+
+**Support Lead:** *@PlantSupport* Perfect! Please save this.


⚠️ [vale] _{reported by reviewdog 🐶}
[FernStyles.Please] Avoid using 'Please' in technical documentation.

github-actions · 2026-08-13T17:34:00Z

+
+**Support Lead:** *@PlantSupport* Perfect! Please save this.
+
+**Plant Support bot –** Successfully indexed! This Q&A pair has been added to your knowledge base and will be used to inform future responses about indoor succulent care.


📝 [vale] _{reported by reviewdog 🐶}
[Microsoft.ExclamationPoints] Use exclamation points sparingly.

github-actions · 2026-08-13T17:34:00Z

+
+**Support Lead:** *@PlantSupport* Perfect! Please save this.
+
+**Plant Support bot –** Successfully indexed! This Q&A pair has been added to your knowledge base and will be used to inform future responses about indoor succulent care.


📝 [vale] _{reported by reviewdog 🐶}
[Microsoft.Wordiness] Consider using 'tell' instead of 'inform'.

github-actions · 2026-08-13T17:34:00Z

+
+**Support Lead:** *@PlantSupport* Perfect! Please save this.
+
+**Plant Support bot –** Successfully indexed! This Q&A pair has been added to your knowledge base and will be used to inform future responses about indoor succulent care.


⚠️ [vale] _{reported by reviewdog 🐶}
[FernStyles.Current] Avoid time-relative terms like 'future' that become outdated

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>

fern-api Bot added 2 commits August 13, 2026 17:13

Completely rewrite the Fern Slack bot page and restructure its navigati…

3ff5fd0

Add a new documentation page about "Fern Agent" — the agentic AI chat b…

83ed1b3

github-actions Bot reviewed Aug 13, 2026

View reviewed changes

fern-api Bot and others added 4 commits August 13, 2026 17:16

Add redirects to docs.yml for the two pages that were moved or remove…

941bc07

docs: fold Fern in Slack rewrite from #6623 into the Fern Agent PR

0ab04b8

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>

docs: avoid time-relative wording in the Slack answers section

5507b11

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>

devin-ai-integration Bot mentioned this pull request Aug 13, 2026

Completely rewrite the Fern Slack bot page and restructure its navigati… #6623

Closed

devin-ai-integration Bot changed the title ~~Add a new documentation page about "Fern Agent" — the agentic AI chat b…~~ Add Fern Agent docs, rewrite Fern in Slack, and consolidate the Slack pages Aug 13, 2026

github-actions Bot reviewed Aug 13, 2026

View reviewed changes

docs: present Fern in Slack as one bot with two capability categories

d215471

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>

devalog marked this pull request as ready for review August 13, 2026 20:55

devalog self-requested a review as a code owner August 13, 2026 20:55

chore: drop vale package files pulled in by vale sync

523baf9

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>


		Does this capture the question and response accurately? Would you like me to adjust anything before saving it to your knowledge base?

		Support Lead: @PlantSupport Perfect! Please save this.


		Support Lead: @PlantSupport Perfect! Please save this.

		Plant Support bot – Successfully indexed! This Q&A pair has been added to your knowledge base and will be used to inform future responses about indoor succulent care.

Uh oh!

Conversation

fern-api Bot commented Aug 13, 2026 • edited by devin-ai-integration Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Validation

Uh oh!

github-actions Bot Aug 13, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot Aug 13, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot Aug 13, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot Aug 13, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot Aug 13, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot Aug 13, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot Aug 13, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot Aug 13, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot Aug 13, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot Aug 13, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot commented Aug 13, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions Bot Aug 13, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot Aug 13, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot Aug 13, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot Aug 13, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot Aug 13, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot Aug 13, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot Aug 13, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot Aug 13, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot Aug 13, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot Aug 13, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

fern-api Bot commented Aug 13, 2026 •

edited by devin-ai-integration Bot

Loading

github-actions Bot commented Aug 13, 2026 •

edited

Loading