From d33b6ca321dce866f06586befc0b53cf17b8ecd6 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 10 Sep 2025 02:20:16 +0000 Subject: [PATCH 1/2] Update ai/writer.mdx --- ai/writer.mdx | 59 +++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 59 insertions(+) create mode 100644 ai/writer.mdx diff --git a/ai/writer.mdx b/ai/writer.mdx new file mode 100644 index 000000000..1957b0a18 --- /dev/null +++ b/ai/writer.mdx @@ -0,0 +1,59 @@ +--- +title: "Writer" +description: "AI-powered documentation assistant that creates and updates docs from Slack threads and web content" +icon: "pen-tool" +--- + + + Writer is currently in testing phase. Try it out in the designated testing channel for feedback and bug reports. + + +Writer is an AI-powered documentation assistant that helps you create and maintain technical documentation directly from Slack conversations and web content. It can read Slack thread links, fetch content from web pages, and perform web searches to generate comprehensive documentation. + +## Key features + +Writer provides several powerful capabilities for documentation creation: + +**Slack thread integration** +- Reads and processes Slack thread links to extract relevant information +- Must be added to the channel you're linking from to access thread content +- Converts conversation context into structured documentation + +**Web content fetching** +- Fetches content from any publicly accessible web page +- Processes HTML content and converts it to documentation format +- Useful for incorporating external resources and references + +**Web search capabilities** +- Performs general web searches similar to AI assistant functionality +- Gathers up-to-date information for documentation accuracy +- Helps research topics and verify technical details + +## Using Writer + +To use Writer in your Slack workspace: + +1. **Mention the bot**: Use `@MintlifyWriter` in channels where it has been added +2. **Provide context**: Share Slack thread links, web URLs, or describe what documentation you need +3. **Review output**: Writer will create or update documentation based on your request +4. **Provide feedback**: Report any issues or suggestions in the testing channel + +## Current limitations + +Writer is in active development with the following known limitations: + +- Cannot re-edit previous pull requests when mentioned again +- Makes separate commits for each file update, which can be repetitive +- Requires manual review for technical accuracy +- Only works with publicly accessible web content for fetching + +## Testing and feedback + +Writer is available for testing with feedback encouraged. When testing: + +- Try different types of content sources (Slack threads, web pages, search queries) +- Report any bugs or unexpected behavior +- Provide suggestions for feature improvements +- Test edge cases and complex documentation scenarios + +The development team actively monitors for bugs and welcomes feedback to improve Writer's capabilities and reliability. \ No newline at end of file From 1a5076966a17b21d98480dbd2b8b5bfa10b57bf7 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 10 Sep 2025 02:20:34 +0000 Subject: [PATCH 2/2] Update docs.json --- docs.json | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs.json b/docs.json index 211ec2010..00211ef9b 100644 --- a/docs.json +++ b/docs.json @@ -61,7 +61,8 @@ "guides/claude-code", "guides/cursor", "guides/windsurf", - "ai/slack-app" + "ai/slack-app", + "ai/writer" ] }, {