Skip to content

Task-linked docs

A document can be linked to one or more tasks, so the write-up for a piece of work stays reachable from the task itself without living inside the task description.

Open a task in Tasks and look for its Documents section. It lists every document currently linked to that task — click one to open it. Linking doesn’t move or copy the document; it’s still the same document in Docs, just reachable from this task too. Removing a document from a task’s Documents section unlinks it — the document itself isn’t deleted.

From a task’s Documents section, use the + button to search your workspace’s documents and pick one to link.

The same + button also offers New document, which creates a new, empty document and links it to the task in one step — if your role allows creating documents. The new document is placed in the same project the task belongs to, so it shows up alongside that project’s other documents in Docs.

Creating a document from a task via the CLI

Section titled “Creating a document from a task via the CLI”

You can do the same thing from the command line:

nrn doc create --task <TEAM-N> [--title <t>] [--content <markdown>]

This creates a document, optionally seeded with a title and markdown content, and links it to the task in one call. See the Docs commands for the rest of the nrn doc commands (view, update, link, unlink, list).