Hule Docs

Appearance

Write a task description ​

Write a description when a task needs more than its title:

  • the steps;
  • the context;
  • a table of figures;
  • a screenshot.

The description is made of blocks. Three characters do most of the work:

TypeTo
/add a block: a heading, a checklist, a table, an image
@mention a person
#mention another task

Before you start ​

Edit access needed

To change a description you need Edit access to the task's list, and a permission set that lets you change the description. Without it you can read the description, but not edit it.

Description editor: open and type ​

  1. Open the task and click the description, or press E. The cursor is in the text, and the toolbar's controls appear above it.

    The description in edit mode with the cursor in the heading and the toolbar above it: block type, text styles, link and listsThe description in edit mode with the cursor in the heading and the toolbar above it: block type, text styles, link and lists

    Change the key

    E is the default key. You can change it in User settings → Hot keys, see Keyboard shortcuts.

  2. Type. Hule saves as you type; there is no Save button. If someone else edits the same description at the same time, each of you sees the other's changes as they type.

The same editor in the New Task form

The Description field of the New Task form works the same way (Create and edit tasks).

Budget example: a description in four blocks ​

Build the description of the task "Draft the Q4 budget":

  1. Type /heading and pick Heading 2. The line turns into a heading.

  2. Type the heading and press Enter:

    text
    Steps

  3. Type /checklist and pick Checklist. A checkbox appears at the start of the line.

  4. Type three steps, pressing Enter after each, then press Enter on the empty item to leave the list:

    text
    Collect the invoices
Fill in the budget template
Send it to the accountant

    Checklist or subtasks?

    A checklist item is text with a checkbox: it has no status, date or assignee. When a step needs those, make it a subtask instead.

  5. Type the start of the next line, then @Anna, and pick Anna from the list:

    text
    Ask @Anna

    Anna's name turns into a chip, and she gets a notification.

  6. Type the rest of the line, then #Q3, and pick the "Q3 budget report" task:

    text
    for the Q3 numbers, see #Q3

    The task turns into a chip, and "Q3 budget report" shows the relation is mentioned in.

  7. On a new line, type /banner and pick Banner Warning. A colored box appears.

  8. Type the deadline:

    text
    The accountant needs it by October 15.

The description of Draft the Q4 budget: the heading Steps, a checklist of three steps, a line with a chip for Anna Smith and one for the task Q3 budget report, and a warning banner with the deadlineThe description of Draft the Q4 budget: the heading Steps, a checklist of three steps, a line with a chip for Anna Smith and one for the task Q3 budget report, and a warning banner with the deadline

Slash menu: add a block ​

The / menu holds every block, grouped by kind. Type a word after the / to narrow it, for example:

text
/check

Pick a block with the arrow keys and Enter, or click it. Every block, with its keys and Markdown shortcuts, is in Editor blocks and shortcuts.

A / typed on an empty line, with the block menu open on its Basic group and Heading 2 in itA / typed on an empty line, with the block menu open on its Basic group and Heading 2 in it

A # starts a mention, not a heading

A # at the start of a word opens a task search. For a heading, use /heading or Block type.

The toolbar follows the cursor

While the cursor is in one of these blocks, the toolbar shows that block's own controls:

  • a table;
  • an image;
  • a code block;
  • a banner;
  • columns;
  • a chip.

Mention a person or a task ​

  1. Type @ at the start of a word. A Search people… chip opens, with a list under it.

  2. Type part of the person's name (spaces are fine), then pick them with the arrow keys and Enter, or click. Esc cancels. The chip shows the person's name.

    @Ann typed: the Search people chip with two people under it, Anna Smith and Annie Walsh@Ann typed: the Search people chip with two people under it, Anna Smith and Annie Walsh

    Who you can mention

    The list offers the workspace's members and the people the list is shared with.

  3. For a task, type # at the start of a word. A Search tasks… chip opens, with your recent tasks under it.

  4. Type part of the task's title or its Task ID, and pick it. The chip shows the task's title and status.

    #Q3 typed: the Search tasks chip with three tasks under it, Q3 budget report first#Q3 typed: the Search tasks chip with three tasks under it, Q3 budget report first

What a mention does:

MentionWhat Hule does
@ a personsends them a notification once, when you add the mention, and adds them to the task's watchers
# a taskadds a mentions relation from this task to that one; the other task shows is mentioned in (Link related tasks)
  • Paste a web link on its own, with nothing selected: it becomes a link preview, a chip with the page's title and icon. Click it to open the page.
  • Paste a screenshot: it becomes an Image block, uploaded to the workspace.
  • Paste a link to a Hule task on its own: it becomes a task mention.
  • Paste formatted text or Markdown: it turns into blocks.

Workspace storage

If an upload fails with Workspace storage limit reached, the workspace has used its storage. Remove files you no longer need from tasks and comments. Storage in Workspace settings shows what is used (Limits).

Every case is in Paste rules.

If it doesn't work ​

  • Typing # opens a task search instead of a heading. # at the start of a word starts a task mention. Press Esc, then use /heading or Block type in the toolbar (Slash menu: add a block).
  • The person you want isn't offered after @. Only the workspace's members and people the list is shared with can be mentioned. Share the list with them, or invite them to the workspace.
  • The task you want isn't offered after #. The search covers the task's own workspace, and only lists you can open. Paste the other task's link on its own: it becomes a mention chip, but a task in another workspace gets no relation (Paste rules).
  • You can't type in the description, and there is no toolbar. Either you have no Edit access to the list (Share a folder or a list), or your permission set can't change the description (Permissions and access). Ask a workspace admin.
  • Pasted text brought formatting you don't want. Undo, then paste with Paste as plain text: Cmd+Shift+V (Ctrl+Shift+V) (Editor keys).
  • A pasted link stayed a plain link, not a preview. A preview appears only when you paste one link on its own, with no text selected (Pasted links and screenshots).