mirror of
				https://github.com/zulip/zulip.git
				synced 2025-11-03 21:43:21 +00:00 
			
		
		
		
	help_docs: Update documentation for editing messages.
Updates various articles related to editing messages (settings, edit history, etc) for changes in UI, adding undocumented settings, and cleaning/linking documentation text and headers.
This commit is contained in:
		
				
					committed by
					
						
						Tim Abbott
					
				
			
			
				
	
			
			
			
						parent
						
							330f0649d7
						
					
				
				
					commit
					e16ede4622
				
			@@ -14,26 +14,27 @@ is highly configurable. Two things are true under any configuration:
 | 
				
			|||||||
* Any message can be deleted at any time by an organization administrator.
 | 
					* Any message can be deleted at any time by an organization administrator.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
<div class="centered_table"></div>
 | 
					<div class="centered_table"></div>
 | 
				
			||||||
|                                    | Admins   | Members |
 | 
					|                                       | Admins   | Members |
 | 
				
			||||||
|---                                 |---       |---      |
 | 
					|---                                    |---       |---      |
 | 
				
			||||||
| Edit your message content          | [1]      | [1]     |
 | 
					| Edit your message content             | [1]      | [1]     |
 | 
				
			||||||
| Edit others' message content       |          |         |
 | 
					| Edit others' message content          |          |         |
 | 
				
			||||||
| Edit your message topics           | [1]      | [1]     |
 | 
					| Edit your message topics              | [1]      | [1]     |
 | 
				
			||||||
| Add a topic to a topicless message | [1]      | [1]     |
 | 
					| Add topic to messages without a topic | [1]      | [1]     |
 | 
				
			||||||
| Edit others' message topics        | [1]      | [2]     |
 | 
					| Edit others' message topics           | [1]      | [2]     |
 | 
				
			||||||
| Move topics between streams        | [4]      | [4]     |
 | 
					| Move topics between streams           | [3]      | [3]     |
 | 
				
			||||||
| Delete your messages               | ✔ | [3]     |
 | 
					| Delete your messages                  | ✔ | [4]     |
 | 
				
			||||||
| Delete others' messages            | ✔ |         |
 | 
					| Delete others' messages               | ✔ |         |
 | 
				
			||||||
 | 
					
 | 
				
			||||||
[1] Controlled by **Allow message editing**.
 | 
					[1] Controlled by **Allow message editing**.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
[2] Controlled by **Who can edit topic of any message**.
 | 
					[2] Controlled by **Who can edit topic of any message**.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
[3] Controlled by **Who can delete their own messages**.
 | 
					[3] Controlled by **Who can move messages between streams**, in
 | 
				
			||||||
 | 
					 | 
				
			||||||
[4] Controlled by **Who can move messages between streams**, in
 | 
					 | 
				
			||||||
addition to other restrictions on editing topics.
 | 
					addition to other restrictions on editing topics.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					[4] Controlled by **Who can delete their own messages**
 | 
				
			||||||
 | 
					and **Time limit for deleting messages**.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
There are a few useful things to understand about the message editing
 | 
					There are a few useful things to understand about the message editing
 | 
				
			||||||
settings.
 | 
					settings.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
@@ -49,31 +50,34 @@ settings.
 | 
				
			|||||||
  in [exports](/help/export-your-organization). Deletion
 | 
					  in [exports](/help/export-your-organization). Deletion
 | 
				
			||||||
  permanently (and irretrievably) removes the message from Zulip.
 | 
					  permanently (and irretrievably) removes the message from Zulip.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
You can access the message editing and deletion settings as follows.
 | 
					## Configure message editing and deletion
 | 
				
			||||||
 | 
					 | 
				
			||||||
### Configure message editing and deletion
 | 
					 | 
				
			||||||
 | 
					
 | 
				
			||||||
{start_tabs}
 | 
					{start_tabs}
 | 
				
			||||||
 | 
					
 | 
				
			||||||
{settings_tab|organization-permissions}
 | 
					{settings_tab|organization-permissions}
 | 
				
			||||||
 | 
					
 | 
				
			||||||
4. Under **Message editing**, configure **Allow message editing**,
 | 
					1. Under **Message editing**, configure:
 | 
				
			||||||
   **Who can edit topic of any message**, and **Who can delete their own messages**.
 | 
					
 | 
				
			||||||
 | 
					    - **Allow message editing**
 | 
				
			||||||
 | 
					    - **Who can edit topic of any message**
 | 
				
			||||||
 | 
					    - **Who can delete their own messages**
 | 
				
			||||||
 | 
					    - **Time limit for deleting messages**
 | 
				
			||||||
 | 
					
 | 
				
			||||||
{!save-changes.md!}
 | 
					{!save-changes.md!}
 | 
				
			||||||
 | 
					
 | 
				
			||||||
{end_tabs}
 | 
					{end_tabs}
 | 
				
			||||||
 | 
					
 | 
				
			||||||
### Configure who can move topics between streams
 | 
					## Configure who can move topics between streams
 | 
				
			||||||
 | 
					
 | 
				
			||||||
By default, only organization administrators can move topics between
 | 
					You can configure which [roles](/help/roles-and-permissions)
 | 
				
			||||||
streams.  You can configure which roles have permission to do so:
 | 
					have permission to move topics between streams.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
{start_tabs}
 | 
					{start_tabs}
 | 
				
			||||||
 | 
					
 | 
				
			||||||
{settings_tab|organization-permissions}
 | 
					{settings_tab|organization-permissions}
 | 
				
			||||||
 | 
					
 | 
				
			||||||
2. Under **Message editing**, configure **Who can move messages between streams**.
 | 
					1. Under **Message editing**, configure
 | 
				
			||||||
 | 
					   **Who can move messages between streams**.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
{!save-changes.md!}
 | 
					{!save-changes.md!}
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 
 | 
				
			|||||||
@@ -179,8 +179,8 @@
 | 
				
			|||||||
* [Restrict private messages](/help/restrict-private-messages)
 | 
					* [Restrict private messages](/help/restrict-private-messages)
 | 
				
			||||||
* [Restrict wildcard mentions](/help/restrict-wildcard-mentions)
 | 
					* [Restrict wildcard mentions](/help/restrict-wildcard-mentions)
 | 
				
			||||||
* [Block image and link previews](/help/allow-image-link-previews)
 | 
					* [Block image and link previews](/help/allow-image-link-previews)
 | 
				
			||||||
 | 
					* [Restrict message editing](/help/configure-message-editing-and-deletion)
 | 
				
			||||||
* [Disable message edit history](/help/disable-message-edit-history)
 | 
					* [Disable message edit history](/help/disable-message-edit-history)
 | 
				
			||||||
* [Manage editing of old messages](/help/configure-message-editing-and-deletion)
 | 
					 | 
				
			||||||
* [Hide message content in emails](/help/hide-message-content-in-emails)
 | 
					* [Hide message content in emails](/help/hide-message-content-in-emails)
 | 
				
			||||||
* [Message retention policy](/help/message-retention-policy)
 | 
					* [Message retention policy](/help/message-retention-policy)
 | 
				
			||||||
* [Weekly digest emails](/help/digest-emails)
 | 
					* [Weekly digest emails](/help/digest-emails)
 | 
				
			||||||
 
 | 
				
			|||||||
@@ -1,26 +1,29 @@
 | 
				
			|||||||
# Require topics in stream messages
 | 
					# Require topics in stream messages
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					Administrators can configure whether stream messages must have a
 | 
				
			||||||
 | 
					specified topic.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					## Require topics in stream messages
 | 
				
			||||||
 | 
					
 | 
				
			||||||
{!admin-only.md!}
 | 
					{!admin-only.md!}
 | 
				
			||||||
 | 
					
 | 
				
			||||||
By default, users are not required to specify a topic in stream messages; if
 | 
					 | 
				
			||||||
a user sends a message without a topic, the message's topic is displayed as
 | 
					 | 
				
			||||||
**(no topic)**.
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
If [message editing](/help/configure-message-editing-and-deletion) is
 | 
					 | 
				
			||||||
enabled, any other user can then edit the topic of messages without a
 | 
					 | 
				
			||||||
topic to set a topic, regardless of the value of the [topic editing
 | 
					 | 
				
			||||||
policy](/help/configure-who-can-edit-topics).
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
You can instead choose to require a topic for new stream messages.
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
### Require topics in stream messages
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
{start_tabs}
 | 
					{start_tabs}
 | 
				
			||||||
 | 
					
 | 
				
			||||||
{settings_tab|organization-settings}
 | 
					{settings_tab|organization-settings}
 | 
				
			||||||
 | 
					
 | 
				
			||||||
2. Under **Message feed**, select **Require topics in messages to streams**.
 | 
					1. Under **Other settings**, toggle
 | 
				
			||||||
 | 
					   **Require topics in streams messages**.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
{!save-changes.md!}
 | 
					{!save-changes.md!}
 | 
				
			||||||
 | 
					
 | 
				
			||||||
{end_tabs}
 | 
					{end_tabs}
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					## Stream messages without a topic
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					If a user sends a message without a topic, the message's topic is
 | 
				
			||||||
 | 
					displayed as **(no topic)**.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					When [message editing](/help/configure-message-editing-and-deletion)
 | 
				
			||||||
 | 
					is enabled, any user can [add a topic](/help/rename-a-topic)
 | 
				
			||||||
 | 
					to messages without a topic. They can do so regardless of whether
 | 
				
			||||||
 | 
					they can [edit topics in general](/help/configure-who-can-edit-topics).
 | 
				
			||||||
 
 | 
				
			|||||||
@@ -1,13 +1,26 @@
 | 
				
			|||||||
# View a message's edit history
 | 
					# View a message's edit history
 | 
				
			||||||
 | 
					
 | 
				
			||||||
By default, users can view the edit history of any edited message. Edited
 | 
					Users can view the edit history of any edited or moved message.
 | 
				
			||||||
messages have `EDITED` written in gray either above or to the left of the
 | 
					
 | 
				
			||||||
message.
 | 
					Messages with any content edits are labeled **EDITED**, while messages
 | 
				
			||||||
 | 
					that have only been [moved to a new
 | 
				
			||||||
 | 
					stream](/help/move-content-to-another-stream) or
 | 
				
			||||||
 | 
					[topic](/help/move-content-to-another-topic) are labeled **MOVED**.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
Organization administrators can
 | 
					Organization administrators can
 | 
				
			||||||
[disable message edit history](/help/disable-message-edit-history).
 | 
					[disable message edit history](/help/disable-message-edit-history).
 | 
				
			||||||
 | 
					
 | 
				
			||||||
### View a message's edit history
 | 
					## View a message's edit history
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					### Via the main message feed
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					{start_tabs}
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					1. Click on the message's **EDITED** or **MOVED** label.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					{end_tabs}
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					### Via the message menu (alternate method)
 | 
				
			||||||
 | 
					
 | 
				
			||||||
{start_tabs}
 | 
					{start_tabs}
 | 
				
			||||||
 | 
					
 | 
				
			||||||
@@ -17,7 +30,13 @@ Organization administrators can
 | 
				
			|||||||
 | 
					
 | 
				
			||||||
!!! warn ""
 | 
					!!! warn ""
 | 
				
			||||||
 | 
					
 | 
				
			||||||
    You will only see **View edit history** in the dropdown menu if
 | 
					    You will only see **View edit history** in the dropdown
 | 
				
			||||||
    the message has been edited and message edit history is on.
 | 
					    menu if the message has been moved or edited, and
 | 
				
			||||||
 | 
					    message edit history is enabled in the organization.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
{end_tabs}
 | 
					{end_tabs}
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					## Related articles
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					* [Restrict message editing](/help/configure-message-editing-and-deletion)
 | 
				
			||||||
 | 
					* [Disable message edit history](/help/disable-message-edit-history)
 | 
				
			||||||
 
 | 
				
			|||||||
		Reference in New Issue
	
	Block a user