Files
zulip/help/collaborative-to-do-lists.md
Lauryn Menard 7a315b7b0e help: Add create a to-do list via compose box button tip.
Adds a tip for creating a collaborative to-do list via the new
compose box button in the markdown formatting article.

Edits the include examples for to-do lists so that the note about
marking a task as complete/incomplete is text before the example
screenshot.

Revises the collaborative to-do list article for a missing comma,
and adjusts some line wrapping.

Fixes #33522.
2025-02-20 10:01:39 -08:00

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 **trash**
(<i class="fa fa-trash-o"></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)