From c5c0d0129a81affd61cad735278e5519a8a02b00 Mon Sep 17 00:00:00 2001 From: "promptless[bot]" <179508745+promptless[bot]@users.noreply.github.com> Date: Wed, 18 Feb 2026 22:47:39 +0000 Subject: [PATCH 1/5] Add "How Promptless Learns Your Docs" page explaining doc analysis --- fern/docs.yml | 2 ++ fern/docs/doc-analysis.mdx | 64 ++++++++++++++++++++++++++++++++++++++ 2 files changed, 66 insertions(+) create mode 100644 fern/docs/doc-analysis.mdx diff --git a/fern/docs.yml b/fern/docs.yml index eb8653f..1804353 100644 --- a/fern/docs.yml +++ b/fern/docs.yml @@ -36,6 +36,8 @@ navigation: path: ./docs/getting-started.mdx - page: Core Concepts path: ./docs/core-concepts.mdx + - page: How Promptless Learns Your Docs + path: ./docs/doc-analysis.mdx - page: Promptless for Open-Source slug: promptless-oss path: ./docs/open-source.mdx diff --git a/fern/docs/doc-analysis.mdx b/fern/docs/doc-analysis.mdx new file mode 100644 index 0000000..ca1e828 --- /dev/null +++ b/fern/docs/doc-analysis.mdx @@ -0,0 +1,64 @@ +--- +title: How Promptless Learns Your Docs +--- + +When you connect your documentation, Promptless analyzes it to understand your product, your writing style, and how your docs are organized. + +## Initial Ingestion + +When you first connect your documentation platform, Promptless ingests and indexes all your existing docs. This typically takes 5-30 minutes, depending on the size of your documentation. + +During ingestion, Promptless: + +- Reads every page in your connected documentation +- Builds a searchable index to find relevant content when analyzing triggers +- Maps relationships between pages, sections, and topics + +## Product Ontology + +Promptless builds an understanding of your product's structure—what features you have, how they relate to each other, and the terminology your team uses. This **product ontology** helps Promptless: + +- Know which documentation pages are relevant when a specific feature changes +- Understand your product's concepts and terminology +- Identify connections between features that might require coordinated documentation updates + +For example, if your product has a "Workspaces" feature with sub-features like "Permissions" and "Invitations," Promptless understands these relationships and can update all relevant pages when workspace behavior changes. + +## Voice and Style Learning + +Promptless analyzes how your documentation is written—tone, sentence structure, formatting patterns, and terminology choices. This powers **Voice Match**, ensuring suggestions sound like they were written by your team. + +Promptless learns patterns like: + +- Whether you write formally or conversationally +- The specific words and phrases you use for concepts +- How you organize content, use headings, and format examples +- Your preferences for capitalization, punctuation, and code formatting + +When drafting content, Promptless references similar existing pages to match their style. + +## What Happens When a Trigger Fires + +When an event triggers Promptless (like a PR merge or Slack message), here's what happens: + + + + Promptless pulls relevant context from connected sources—PR details, linked issues in Linear or Jira, related Slack conversations, and your existing documentation. + + + + Promptless analyzes what changed and determines which parts of your documentation might be affected. This uses the product ontology to identify related features and pages. + + + + Using Voice Match, Promptless drafts documentation updates that match your existing style. Every change includes citations showing where the information came from. + + + + Promptless creates a suggestion for your review. You can edit, provide feedback, or publish directly. + + + +## Continuous Learning + +Promptless continues learning as you use it. When you edit suggestions or provide feedback, Promptless learns your preferences for future suggestions. As your documentation grows and changes, Promptless adapts to your evolving style and automatically re-indexes when you publish updates to stay current. From 4a1cbfbecb908d8d5143edd6d1e8ada5daee44bc Mon Sep 17 00:00:00 2001 From: "promptless[bot]" <179508745+promptless[bot]@users.noreply.github.com> Date: Wed, 18 Feb 2026 23:16:11 +0000 Subject: [PATCH 2/5] Sync documentation updates --- fern/docs/doc-analysis.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/fern/docs/doc-analysis.mdx b/fern/docs/doc-analysis.mdx index ca1e828..cfc9700 100644 --- a/fern/docs/doc-analysis.mdx +++ b/fern/docs/doc-analysis.mdx @@ -2,7 +2,7 @@ title: How Promptless Learns Your Docs --- -When you connect your documentation, Promptless analyzes it to understand your product, your writing style, and how your docs are organized. +Before creating the first suggestion, Promptless analyzes your existing docs to understand the product, writing style, and how your docs are organized. ## Initial Ingestion From ea766c00f3f87cce1957a84ee7d703fb3dd202aa Mon Sep 17 00:00:00 2001 From: "promptless[bot]" <179508745+promptless[bot]@users.noreply.github.com> Date: Wed, 18 Feb 2026 23:18:52 +0000 Subject: [PATCH 3/5] Sync documentation updates --- fern/docs/doc-analysis.mdx | 2 -- 1 file changed, 2 deletions(-) diff --git a/fern/docs/doc-analysis.mdx b/fern/docs/doc-analysis.mdx index cfc9700..1ee49cc 100644 --- a/fern/docs/doc-analysis.mdx +++ b/fern/docs/doc-analysis.mdx @@ -6,8 +6,6 @@ Before creating the first suggestion, Promptless analyzes your existing docs to ## Initial Ingestion -When you first connect your documentation platform, Promptless ingests and indexes all your existing docs. This typically takes 5-30 minutes, depending on the size of your documentation. - During ingestion, Promptless: - Reads every page in your connected documentation From 7b4e532f6af403a483c2b8ed6656215559150f3e Mon Sep 17 00:00:00 2001 From: "promptless[bot]" <179508745+promptless[bot]@users.noreply.github.com> Date: Wed, 18 Feb 2026 23:21:56 +0000 Subject: [PATCH 4/5] Sync documentation updates --- fern/docs/doc-analysis.mdx | 24 ------------------------ 1 file changed, 24 deletions(-) diff --git a/fern/docs/doc-analysis.mdx b/fern/docs/doc-analysis.mdx index 1ee49cc..45f9864 100644 --- a/fern/docs/doc-analysis.mdx +++ b/fern/docs/doc-analysis.mdx @@ -6,8 +6,6 @@ Before creating the first suggestion, Promptless analyzes your existing docs to ## Initial Ingestion -During ingestion, Promptless: - - Reads every page in your connected documentation - Builds a searchable index to find relevant content when analyzing triggers - Maps relationships between pages, sections, and topics @@ -35,28 +33,6 @@ Promptless learns patterns like: When drafting content, Promptless references similar existing pages to match their style. -## What Happens When a Trigger Fires - -When an event triggers Promptless (like a PR merge or Slack message), here's what happens: - - - - Promptless pulls relevant context from connected sources—PR details, linked issues in Linear or Jira, related Slack conversations, and your existing documentation. - - - - Promptless analyzes what changed and determines which parts of your documentation might be affected. This uses the product ontology to identify related features and pages. - - - - Using Voice Match, Promptless drafts documentation updates that match your existing style. Every change includes citations showing where the information came from. - - - - Promptless creates a suggestion for your review. You can edit, provide feedback, or publish directly. - - - ## Continuous Learning Promptless continues learning as you use it. When you edit suggestions or provide feedback, Promptless learns your preferences for future suggestions. As your documentation grows and changes, Promptless adapts to your evolving style and automatically re-indexes when you publish updates to stay current. From eb020143fd652d5f03f491918832d92dbcc6b796 Mon Sep 17 00:00:00 2001 From: "promptless[bot]" <179508745+promptless[bot]@users.noreply.github.com> Date: Wed, 18 Feb 2026 23:25:14 +0000 Subject: [PATCH 5/5] Sync documentation updates --- fern/docs/doc-analysis.mdx | 1 - 1 file changed, 1 deletion(-) diff --git a/fern/docs/doc-analysis.mdx b/fern/docs/doc-analysis.mdx index 45f9864..38b1da2 100644 --- a/fern/docs/doc-analysis.mdx +++ b/fern/docs/doc-analysis.mdx @@ -6,7 +6,6 @@ Before creating the first suggestion, Promptless analyzes your existing docs to ## Initial Ingestion -- Reads every page in your connected documentation - Builds a searchable index to find relevant content when analyzing triggers - Maps relationships between pages, sections, and topics