Docs
Collaborative channel documents, linked pages, editing modes and suggestions, with access inherited from the channel.
- Modes
- First-party, or connected.
- First-party
- Included.
- Connect instead
- Notion or Google Docs.
- Who holds the record
- Crusible, until you connect Notion or Google Docs — then it does.
- What it shows
- Channel documents with shared editing, comments, linked pages and a suggestion review rail.
- Controls
- Editing mode, Insert, Show suggestions, Show comments, Show versions, Show document info and Share.
- What agents do here
- Agents can propose suggestions or make permitted document changes. Pending suggestions are separate from direct edits.
Docs holds documents for a channel. People can work in the same document, comment on selected text and review suggestions. A link opens a particular document; it does not grant access.
Find and create documents
Search this channel finds text across channel documents. Search results can lag behind the current document.
New linked document creates another document in the channel. Creation and link insertion are separate actions. Linked documents lists documents available to link from the editor’s Insert menu.
An empty document offers Design / spec outline, Meeting notes and Decision record under Start from. Each supplies a starting structure with prompts for the document’s content.
Create and share a document covers creating a page, inserting its link and sharing it.
Edit, suggest and review
The Editing mode control offers Edit, Suggest, Review and Read only. Edit changes the document directly. Suggest proposes changes for review. Selecting a mode does not grant permission to write.
Agent changes can be suggestions or direct edits when permitted. An unchanged suggestion count does not establish that nobody edited the document. Show suggestions displays pending proposals and their authors. Accept suggestion applies a proposed change; Reject suggestion leaves the proposed change out.
Show comments displays discussion. Comment on selection attaches a comment to selected text. Comments and suggestions are separate: leaving a comment does not accept a proposal.
Review agent suggestions in docs covers decisions and comments on proposals.
Blocks you can insert
The Insert menu contains the following blocks. Its search filters the list by block name.
| Block | Use |
|---|---|
| Paragraph | Ordinary text. |
| Heading 1, Heading 2, Heading 3 | Section headings. |
| Bulleted list, Numbered list, To-do list | Lists and checkable tasks. |
| Quote, Callout | Quoted text or a highlighted note. |
| Code block | A separate code sample. |
| Divider | A section break. |
| Image | An image uploaded into a saved document. |
| Linked documents | A link to another document in the channel. |
Image needs a saved document. Supported uploads are PNG, JPEG, GIF, WebP and AVIF. Alt text holds the image description. A failed upload offers Retry or Remove.
File and Video or external embed can appear disabled with Storage required. The menu does not offer table, diagram, issue or review block insertion. A rich block already present in a document does not establish an insertion control in this menu.
Concurrent edits and versions
Other editors’ changes can arrive while you work, including changes to a passage with a pending suggestion. An offline or stale document cannot complete a suggestion verdict.
Show versions displays named versions. Name this version creates a named version of the document. Restoring a version adds its content as a new edit; it preserves earlier versions. Show document info contains the outline, contributors and last-edited information. The contributors list uses named versions and comments; it is not a complete audit of every edit.
Share a document
Share contains Copy link. Link copied confirms a successful copy. The recipient still needs access to the document.
People with access reports the access the service can resolve, including whether it comes through the channel, workspace or organization. This dialog does not grant access. Inviting a specific person and granting organization-wide access from this dialog are unavailable. Missing access requires a workspace administrator.
Rich content and refreshes
An embedded object has its own availability status. Stored document content and a successful read of an upstream tool are different things. Reopening a document does not establish that upstream data has refreshed.
A loading or error state belongs to the affected block. Some block errors offer Retry. A retry does not grant permission to a missing or restricted source. Docs has no general build cancellation or refresh control for every block.
Document access and connected tools
Docs edits documents stored in Crusible. It has no provider selector for switching the editor to Google Docs, Notion or another connected tool. A link to an external document does not copy its contents into this editor or grant access to that tool.
For a Crusible document, check channel access and the People with access list under Share. A connected-tool permission cannot grant access to a Crusible document.