Files
zulip/help/collaborative-to-do-lists.md

95 lines
2.2 KiB
Markdown

# Collaborative to-do lists
{!to-do-lists-intro.md!}
## Create a to-do list
{start_tabs}
{tab|via-compose-box-buttons}
{!start-composing.md!}
1. Make sure the compose box is empty.
1. Click the **Add to-do list** (<i class="zulip-icon
zulip-icon-todo-list"></i>) icon at the bottom of the compose box.
1. Fill out todo-list information as desired, and click **Create to-do
list** to insert todo-list formatting.
1. Click the **Send** (<i class="zulip-icon zulip-icon-send"></i>)
button, or use a [keyboard shortcut](/help/configure-send-message-keys)
to send your message.
!!! tip ""
To reorder the list of todos, click and drag the **vertical dots**
(<i class="zulip-icon zulip-icon-grip-vertical"></i>) to the left of
each option. To delete an option, click the **delete**
(<i class="zulip-icon zulip-icon-trash"></i>) icon to the right of it.
{tab|via-markdown}
{!start-composing.md!}
1. Make sure the compose box is empty.
1. Type `/todo` followed by a space, and the title of the to-do list.
1. _(optional)_ Type each task on a new line, with its description, if
any, after a <kbd>:</kbd> and blank space.
1. Click the **Send** (<i class="zulip-icon zulip-icon-send"></i>)
button, or use a [keyboard shortcut](/help/configure-send-message-keys)
to send your message.
!!! tip ""
You will be able to add tasks after the to-do list is created.
{end_tabs}
## Add tasks to a to-do list
{start_tabs}
1. Fill out the **New task** field, and optionally the **Description**
field at the bottom of the to-do list.
1. Click **Add task** to add the new task to the to-do list.
{end_tabs}
## Edit the to-do list title
!!! warn ""
Only the creator of a to-do list can edit the title.
{start_tabs}
1. Click the **pencil** (<i class="fa fa-pencil"></i>) icon
to the right of the title.
1. Edit the title as desired.
1. Click the **checkmark** (<i class="fa fa-check"></i>) icon or press
<kbd>Enter</kbd> to save your changes.
!!! tip ""
You can click the <i class="fa fa-remove"></i> icon or press
<kbd>Esc</kbd> to discard your changes.
{end_tabs}
## Examples
{!to-do-lists-examples.md!}
## Related articles
* [Message formatting](/help/format-your-message-using-markdown)
* [Polls](/help/create-a-poll)