mirror of
				https://github.com/zulip/zulip.git
				synced 2025-11-03 21:43:21 +00:00 
			
		
		
		
	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.
		
			
				
	
	
		
			95 lines
		
	
	
		
			2.2 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
			
		
		
	
	
			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)
 |