help: Update drafts documentation.

- Document new auto-restore functionality.
- Document opening drafts view from compose box.
- Restructure sections.
This commit is contained in:
Alya Abbott 2024-04-22 14:34:44 -07:00 committed by Tim Abbott
parent 363ea09710
commit 7aa90440ed
1 changed files with 76 additions and 19 deletions

View File

@ -1,8 +1,9 @@
# Draft messages # Draft messages
Zulip automatically saves the content of your message as a draft when you Zulip automatically saves the content of your message as a draft when you close
close the compose box, ensuring that you never lose your work. Drafts are the compose box, ensuring that you never lose your work. When you start
saved for 30 days. composing, the most recently edited draft for the conversation you are composing
to automatically appears in the compose box. Drafts are saved for 30 days.
!!! warn "" !!! warn ""
@ -11,6 +12,8 @@ saved for 30 days.
## Save a draft ## Save a draft
### Save a draft and stop composing
{start_tabs} {start_tabs}
{tab|desktop-web} {tab|desktop-web}
@ -31,23 +34,56 @@ saved for 30 days.
{end_tabs} {end_tabs}
## Edit a draft ### Save a draft and start a new message
{start_tabs} {start_tabs}
{tab|desktop-web} {tab|desktop-web}
{!start-composing.md!}
1. Click on the **ellipsis** (<i class="zulip-icon zulip-icon-more-vertical"></i>)
in the bottom right corner of the compose box, next to the **Send**
(<i class="zulip-icon zulip-icon-send"></i>) button.
1. Select **Save draft and start a new message**.
{end_tabs}
## Restore a draft
To make it easier to find the draft you are looking for, drafts for the
conversation you are composing to are shown at the top of the drafts list in the
web and desktop apps. If you have saved drafts for the current conversation, the
counter next to the **Drafts** button in the compose box shows how many there are.
{start_tabs}
{tab|via-left-sidebar}
{!go-to-draft-messages.md!} {!go-to-draft-messages.md!}
1. Click the **pencil** (<i class="fa fa-pencil"></i>) icon on the draft you 1. Click the **pencil** (<i class="fa fa-pencil"></i>) icon on the draft you
want to edit. want to restore.
1. Edit the message.
!!! keyboard_tip "" !!! keyboard_tip ""
You can also use <kbd>Enter</kbd> within the drafts view to restore the You can also use <kbd>D</kbd> to bring up your list of saved drafts, and
selected draft. <kbd>Enter</kbd> within the drafts view to restore the selected draft.
{tab|via-compose-box-buttons}
{!start-composing.md!}
1. Click the **Drafts** button on the right side of the compose box.
1. Click the **pencil** (<i class="fa fa-pencil"></i>) icon on the draft you
want to restore.
!!! keyboard_tip ""
You can also use <kbd>D</kbd> to bring up your list of saved drafts, and
<kbd>Enter</kbd> within the drafts view to restore the selected draft.
{end_tabs} {end_tabs}
@ -57,7 +93,7 @@ saved for 30 days.
{start_tabs} {start_tabs}
{tab|desktop-web} {tab|via-left-sidebar}
{!go-to-draft-messages.md!} {!go-to-draft-messages.md!}
@ -66,8 +102,22 @@ saved for 30 days.
!!! keyboard_tip "" !!! keyboard_tip ""
You can also use <kbd>Backspace</kbd> within the drafts view to delete the You can also use <kbd>D</kbd> to bring up your list of saved drafts, and
selected draft. <kbd>Backspace</kbd> within the drafts view to delete the selected draft.
{tab|via-compose-box-buttons}
{!start-composing.md!}
1. Click the **Drafts** button on the right side of the compose box.
1. Click the **trash** (<i class="fa fa-trash-o"></i>) icon on the draft you
want to delete.
!!! keyboard_tip ""
You can also use <kbd>D</kbd> to bring up your list of saved drafts, and
<kbd>Backspace</kbd> within the drafts view to delete the selected draft.
{end_tabs} {end_tabs}
@ -75,7 +125,7 @@ saved for 30 days.
{start_tabs} {start_tabs}
{tab|desktop-web} {tab|via-left-sidebar}
{!go-to-draft-messages.md!} {!go-to-draft-messages.md!}
@ -86,19 +136,26 @@ saved for 30 days.
1. Click the **trash** (<i class="fa fa-trash-o"></i>) icon in the 1. Click the **trash** (<i class="fa fa-trash-o"></i>) icon in the
upper right corner of the drafts view to delete all selected drafts. upper right corner of the drafts view to delete all selected drafts.
{end_tabs} !!! keyboard_tip ""
## View your drafts You can also use <kbd>D</kbd> to bring up your list of saved drafts.
{start_tabs} {tab|via-compose-box-buttons}
{tab|desktop-web} {!start-composing.md!}
{!go-to-draft-messages.md!} 1. Click the **Drafts** button on the right side of the compose box.
1. Click **Select all drafts** in the upper right corner of
the drafts view, or select the drafts you want to delete
by toggling the checkboxes on the right.
1. Click the **trash** (<i class="fa fa-trash-o"></i>) icon in the
upper right corner of the drafts view to delete all selected drafts.
!!! keyboard_tip "" !!! keyboard_tip ""
Use <kbd>D</kbd> to bring up your list of saved drafts. You can also use <kbd>D</kbd> to bring up your list of saved drafts.
{end_tabs} {end_tabs}