diff --git a/fern/docs.yml b/fern/docs.yml index 66bd90e8..b0150144 100644 --- a/fern/docs.yml +++ b/fern/docs.yml @@ -90,6 +90,15 @@ navigation: path: ./docs/features/web-ui-feedback.mdx - page: Providing Feedback path: ./docs/features/providing-feedback.mdx + - section: Use Cases + icon: fa-regular fa-lightbulb + contents: + - page: For Engineering Teams + path: ./docs/use-cases/engineering-teams.mdx + - page: For Technical Writers + path: ./docs/use-cases/technical-writers.mdx + - page: Support Tickets to Docs + path: ./docs/use-cases/support-to-docs.mdx - section: Integrations icon: fa-regular fa-plug path: ./docs/integrations/index.mdx diff --git a/fern/docs/use-cases/engineering-teams.mdx b/fern/docs/use-cases/engineering-teams.mdx new file mode 100644 index 00000000..fe196be9 --- /dev/null +++ b/fern/docs/use-cases/engineering-teams.mdx @@ -0,0 +1,52 @@ +--- +title: For Engineering Teams +description: Keep documentation in sync with code changes by automatically generating updates from pull requests +--- + +Promptless monitors your pull requests. When code changes, it generates documentation updates using PR descriptions and context from Linear or Jira. + +## WHAT PROMPTLESS ANALYZES + +This is EDIT!!!! + +When a PR is opened, Promptless reviews: +- The code diff and changed files +- The PR title and description +- Related issues in Linear or Jira +- Historical patterns in your documentation + +## PUBLISHING MODES + +**Auto-publish mode**: Promptless creates a docs PR linked to your source PR. When your PR merges, the docs PR is ready for review. + +**Draft mode**: Review suggestions in the web interface before any PR is created. + +## PROVIDING FEEDBACK + +Tag @Promptless in GitHub PR comments to request changes. Promptless updates the suggestion accordingly. + +## TYPICAL WORKFLOW + +1. Engineer opens a PR with code changes +2. Promptless analyzes the PR and related context +3. Promptless generates a documentation suggestion +4. Team gets notified in Slack +5. Reviewers provide feedback via PR comments or web interface +6. Documentation publishes when approved + +## GETTING STARTED + + + + [Connect GitHub](/docs/integrations/github-integration) to enable PR monitoring. + + + [Create a project](/docs/getting-started) with GitHub as your trigger. + + + Connect [Linear](/docs/integrations/linear-integration) or [Jira](/docs/integrations/atlassian-integration) for richer context. + + + Set up a Slack channel for notifications. + + diff --git a/fern/docs/use-cases/support-to-docs.mdx b/fern/docs/use-cases/support-to-docs.mdx new file mode 100644 index 00000000..8faefe4e --- /dev/null +++ b/fern/docs/use-cases/support-to-docs.mdx @@ -0,0 +1,48 @@ +--- +title: Support Tickets to Docs +description: Automatically identify documentation gaps from support tickets and generate content that helps future customers +--- + +Resolved support tickets contain valuable knowledge—troubleshooting steps, workarounds, and explanations that could help future customers. Promptless analyzes your Zendesk tickets to identify documentation gaps and generate content based on solutions your team already provides. + +## WHAT PROMPTLESS DOES + +When a ticket is resolved, Promptless: + +- Identifies patterns across similar tickets +- Detects topics missing from your documentation +- Extracts solutions and troubleshooting steps +- Drafts troubleshooting guides, FAQ entries, and feature explanations + +## PUBLISHING OPTIONS + +Promptless can publish directly to: + +- Zendesk help centers +- Intercom help content (Beta) +- Any documentation platform connected to your project + +## TYPICAL WORKFLOW + +1. Support team resolves a ticket +2. Promptless analyzes the ticket and related context +3. If documentation should be updated, a suggestion is generated +4. A technical writer or support lead reviews and approves +5. Content publishes to your help center + +## GETTING STARTED + + + + [Set up the Zendesk integration](/docs/integrations/zendesk) to enable ticket analysis. + + + Create a project with Zendesk as your trigger. + + + Connect Zendesk help center or another documentation platform. + + + Configure notifications for your support or documentation team. + + diff --git a/fern/docs/use-cases/technical-writers.mdx b/fern/docs/use-cases/technical-writers.mdx new file mode 100644 index 00000000..4a193d3d --- /dev/null +++ b/fern/docs/use-cases/technical-writers.mdx @@ -0,0 +1,44 @@ +--- +title: For Technical Writers +description: Focus on documentation strategy while Promptless handles routine updates and keeps you informed about product changes +--- + +Promptless handles routine documentation work so you can focus on information architecture and strategy. Instead of attending standups and chasing engineers for context, you get notified when docs need updating—with all the context you need in one place. + +## HOW PROMPTLESS HELPS + +Promptless monitors your configured trigger sources and notifies you when documentation updates are needed. You receive notifications in a dedicated Slack channel whenever Promptless detects documentation-worthy changes. + +### CONTEXT AT A GLANCE + +When reviewing a suggestion, you see: +- The PR or trigger that initiated the update +- Related Linear or Jira issues +- Relevant Slack conversations +- The proposed documentation changes + +### PROVIDE FEEDBACK + +Use the web interface to: +- Highlight text and add comments +- Request changes that Promptless applies automatically +- Save feedback preferences for future suggestions (e.g., "always include code examples for API endpoints") + +### AUDIT TRAIL + +The Triggers page shows all events from the last 30 days. Track what triggered each documentation update and audit your process. + +## TYPICAL WORKFLOW + +1. Promptless monitors PRs, Slack, and other triggers +2. You receive a notification when docs need updating +3. Review the suggestion and related context in the web interface +4. Provide feedback to refine the suggestion +5. Approve and publish when ready + +## GETTING STARTED + +1. Connect your documentation platform via [GitHub](/docs/integrations/github-integration) or another doc collection +2. Create a project with your preferred triggers +3. Set up a dedicated Slack channel for notifications +4. Connect context sources like [Linear](/docs/integrations/linear-integration) or [Jira](/docs/integrations/atlassian-integration)