diff --git a/apps/docs/communications.mdx b/apps/docs/communications.mdx
index e854be4fa..6e4d2601a 100644
--- a/apps/docs/communications.mdx
+++ b/apps/docs/communications.mdx
@@ -42,6 +42,9 @@ After connecting the provider, run a small task from chat and confirm that:
 - replies in the thread continue the same task
 - final summaries and links are posted back to chat
 
+In Slack, task and automation messages can link to all active pull requests
+associated with the task.
+
 ## Start suggested tasks
 
 When a task or automation report identifies independent follow-up work, Roomote
diff --git a/apps/docs/file-attachments.mdx b/apps/docs/file-attachments.mdx
index c45cff231..ae00cd6ff 100644
--- a/apps/docs/file-attachments.mdx
+++ b/apps/docs/file-attachments.mdx
@@ -8,10 +8,11 @@ Roomote can read supported file attachments from the web app and from chat
 threads where you start or continue a Roomote task.
 
 Support varies by chat provider. The web app, Slack, and Telegram can read the
-formats below. Discord supports images and a smaller text and code subset, but
-not Office documents, PDFs, or presentations. Microsoft Teams currently
-supports image attachments only. Slack can also describe one supported video
-attachment per message.
+text, document, and image formats below. Discord supports images and a smaller
+text and code subset, but not Office documents, PDFs, or presentations. Slack,
+Discord, Microsoft Teams, and Telegram can also transcribe supported audio
+attachments. Microsoft Teams otherwise supports image attachments only, and
+Slack can describe one supported video attachment per message.
 
 Use attachments when the file itself is the fastest way to show the problem: a
 bug report export, a config file, a markdown handoff, a spreadsheet, or a PDF
@@ -34,8 +35,8 @@ If the attachments are large, Roomote reads them in the order you attach them
 and applies a shared text budget so the task stays responsive. Very large
 earlier files can leave later files included by name only.
 
-Text-extracted files are limited to 8 MB each. Image, video, and provider
-transport limits vary by surface.
+Text-extracted files are limited to 8 MB each. Audio files are limited to 20
+MiB each. Image, video, and provider transport limits vary by surface.
 
 ## Accepted file types
 
@@ -48,6 +49,7 @@ transport limits vary by surface.
 | Documents       | `.pdf`, `.docx`                                                                                                                               |
 | Presentations   | `.pptx`                                                                                                                                       |
 | Images          | `.png`, `.jpg`, `.jpeg`, `.gif`, `.webp`, `.svg`                                                                                              |
+| Audio (chat)    | `.aac`, `.flac`, `.m4a`, `.mp3`, `.mp4`, `.oga`, `.ogg`, `.opus`, `.wav`, `.webm`                                                            |
 
 ## How Roomote uses them
 
@@ -55,7 +57,10 @@ Text, code, spreadsheet, document, and presentation files are read into the
 task as attachment context. Images are passed through as image inputs so
 Roomote can inspect them directly. `.svg` files are normally read as text
 markup, but Discord treats an SVG reported with the `image/svg+xml` content type
-as an image input.
+as an image input. In Slack, Discord, Microsoft Teams, and Telegram, supported
+audio is transcribed and the transcript is added to the task context. Where a
+provider permits multiple audio attachments in one message, Roomote transcribes
+only the first one.
 
 That means you can ask things like:
 
@@ -80,5 +85,10 @@ That means you can ask things like:
   log window, or section. Text-extracted files larger than 8 MB are rejected.
 - **The attachment is a format not listed here.** Export it as one of the
   accepted formats above.
+- **The audio was not transcribed.** Audio must be no larger than 20 MiB, use a
+  supported format, and have an audio-capable inference model available.
+  Roomote adds a warning to the task context when the format, size, model,
+  download, or transcription prevents processing, so the text portion of the
+  request can still proceed.
 - **The task still needs more context.** Add a short prompt that explains the
   question, expected behavior, or failure you want Roomote to investigate.
diff --git a/apps/docs/tasks.mdx b/apps/docs/tasks.mdx
index 04ae6393b..39142b1dc 100644
--- a/apps/docs/tasks.mdx
+++ b/apps/docs/tasks.mdx
@@ -44,6 +44,10 @@ detail to review the work. Presentational widgets remain available in the task
 transcript; when an agent provides a text fallback, Roomote also sends that
 fallback to the originating Slack, Teams, Telegram, or Discord conversation.
 
+When a task is associated with more than one pull request, the task header and
+**Task Info** panel list each linked pull request separately. Select a pull
+request to open it in its source-control provider.
+
 ### Native widget styling
 
 Roomote widgets inherit the task view's selected light or dark theme. Agents can