> ## Documentation Index
> Fetch the complete documentation index at: https://docs.there.do/llms.txt
> Use this file to discover all available pages before exploring further.

# Brief

> Lay out sheets and structured reports: a heading on the left, its details on the right

The Brief block lays out a sheet in two columns: a short heading on the left, its details on the right. Use it for method statements, technical memos and fact sheets, instead of a two-column table.

> [!NOTE]
>
> To add this block, on an empty line of the document (not inside another
> block), type `/brief` then select
> &#x20;**Brief**.

## Rows

A brief is made of rows, each with a heading and its content.

* A **section** row opens a part of the brief; a brief always starts with one. A line in the document's colour runs over the heading and another over the content, and its first paragraph reads as the part's title.
* A **detail** row details the section above it. Its heading is grey, and a dashed line separates it from the previous detail.
* A detail row with no heading reads as one item of a list: use it for a series of points, each with a bold title and a short description.

The right column holds what a column holds: text, lists, checklists, tables, images, callouts. Type `/` there to add a block.

## Editing

* Press `Enter` or `Tab` in a heading to go to its content. In an entirely empty row, `Enter` takes the next step described below instead, while `Tab` still goes to the content. From a paragraph of the content, `Shift` + `Tab` brings you back to the heading; in a list, it outdents the item.
* At the end of a text, each press of `Enter` goes one step further: a new line, then a new detail row, then that empty row becomes a section, then it goes: you leave the brief if it was the last row, otherwise you go on to the next row. A row with text is never changed by `Enter`.
* Press `Backspace` in an empty row to remove it.
* Hover a row and click its handle  to switch it between section and detail, insert a row above or below, comment, duplicate or delete it. Drag the handle to move the row, within the brief or to another one.
* Hover the brief and click **+** under its last row to add a section.
* In the block menu  of the brief, **Label column colour** fills that column; the default colour takes it away.

Several briefs can follow each other: add a new Brief block for each sheet.

## Appearance

Headings are in small capitals: in the document's primary colour for sections, in grey for details. Select a heading's text to make it bold or italic, change its colour or alignment. You can fill the heading column with a light shade of a colour, or with the solid primary or secondary colour of the document: the headings then turn black or white, whichever reads best.

In the PDF, a row is never split across two pages when it fits on one, and spacing is tighter. On a narrow screen, each heading goes above its content.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.