Documents
Keep longer notes and supporting context on an Issue.
Image placeholder: Supporting Document
Show an Integrity Document attached to a synthetic Issue, with its title, breadcrumb, and a short decision record.
Overview
Use the Issue description for the main task and supporting Documents for longer notes. Documents live in the Issue's Resources row and inherit access from that Issue. They do not create independent sharing permissions.
Create documents
- Open the Issue.
- Choose New document from Resources.
- Give it a title and write its content on the page that opens.
Edit documents
Click in the body to edit when you have permission. Changes save collaboratively, and other active editors can appear with cursors. A read-only Issue or lost permission also limits its Documents.
Version history (coming soon)
The Document history control is not active. Current edit information is available, but browsing and restoring older versions is not.
Show author names (coming soon)
Per-passage author labels are not active. The Document's edit information can show its creator and last editor.
Image placeholder: Document authorship
Show current Created by and Last edit by information. Reserve per-passage author labels for a future illustration.
Editor slash commands
Type / to insert headings, lists, checklists, code, tables, dividers, callouts, or collapsible sections. See Editor.
Document templates (coming soon)
Templates are not available. You can duplicate an existing supporting Document on its current parent, then edit the independent copy.
Document subscriptions (coming soon)
Documents do not have an independent subscription workflow. Document body edits do not send Inbox or email notifications. Following the parent Issue does not turn every document edit into an alert.
Image placeholder: Document subscribers
Future illustration (coming soon). Show the future document-following control with synthetic readers.
Image placeholder: Document notifications
Future illustration (coming soon). Show a future Inbox entry for a document update, once supported.
Document comments (coming soon)
Inline Document threads are not available. Discuss the Document in the parent Issue's Activity and include its link.
Image placeholder: Resolved document comments
Future illustration (coming soon). Show the future control for finding resolved inline threads.
Open documents
Select the Document in the Issue's Resources row. Accessible supporting Documents can also appear in search and Favorites. Renaming a Document does not change its saved URL.
Reference documents
Copy the Document's URL and add it as a link where needed. Readers still need access to its parent. Selecting Documents through an @ mention picker is (coming soon).
Link to headers (coming soon)
Shareable links to individual headings inside a Document are not available. Share the Document URL and name the section instead.
Image placeholder: Heading link
Future illustration (coming soon). Show the future copy-link control beside a Document heading.