help: Update documentation on editing and moving messages.

- Updates reflect recent settings changes.
- Also update links from other help pages.
This commit is contained in:
Alya Abbott 2023-02-08 14:06:02 -08:00 committed by Tim Abbott
parent 6992d3297a
commit 66919ffa90
18 changed files with 134 additions and 119 deletions

View File

@ -1,83 +1,52 @@
# Configure message editing and deletion # Restrict message editing and deletion
{!admin-only.md!} {!admin-only.md!}
There are several settings that control who can [edit and delete Zulip lets you separately configure permissions for editing and deleting
messages](/help/edit-or-delete-a-message) and topics. By default, messages, and you can set time limits for both actions. Regardless of the
users have 10 minutes after posting a message to edit it, they can configuration you select:
edit any topic at any time, and they cannot delete their messages.
Different organizations have different message editing needs, so this area
is highly configurable. Two things are true under any configuration:
* Message content can only ever be modified by the original author. * Message content can only ever be modified by the original author.
* 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> Note that if a user can edit a message, they can also "delete" it by removing
| | Admins | Members | all the message content. This is different from proper message deletion in two
|--- |--- |--- | ways: the original content will still show up in [message edit
| Edit your message content | [1] | [1] | history](/help/view-a-messages-edit-history), and will be included in
| Edit others' message content | | | [exports](/help/export-your-organization). Deletion permanently (and
| Edit your message topics | [1] | [1] | irretrievably) removes the message from Zulip.
| Add topic to messages without a topic | [1] | [1] |
| Edit others' message topics | [1] | [2] |
| Move topics between streams | [3] | [3] |
| Delete your messages | &#10004; | [4] |
| Delete others' messages | &#10004; | |
[1] Controlled by **Allow message editing**. ## Configure message editing permissions
[2] Controlled by **Who can edit topic of any message**. !!! tip ""
[3] Controlled by **Who can move messages between streams**, in Users can only edit their own messages.
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
settings.
* **Allow message editing** can be set to **Never**, **Any time** or
**Up to [a customizable time limit] after posting**. If set to **Never**,
users cannot edit message topics either. For any other value, users can
edit message topics at any time.
* If a user can edit a message, they can also "delete" it by removing all
the message content. This is different from proper message deletion in two
ways: the original content will still show up in
[message edit history](view-a-messages-edit-history), and will be included
in [exports](/help/export-your-organization). Deletion
permanently (and irretrievably) removes the message from Zulip.
## Configure message editing and deletion
{start_tabs} {start_tabs}
{settings_tab|organization-permissions} {settings_tab|organization-permissions}
1. Under **Message and topic editing**, configure: 1. Under **Message editing**:
- Toggle **Allow message editing**.
- **Allow message editing** - Configure **Time limit for editing messages**.
- **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 message deletion permissions
You can configure which [roles](/help/roles-and-permissions) !!! tip ""
have permission to move topics between streams.
Administrators can always delete any message.
{start_tabs} {start_tabs}
{settings_tab|organization-permissions} {settings_tab|organization-permissions}
1. Under **Message and topic editing**, configure 1. Under **Message deletion**:
**Who can move messages between streams**. - Configure **Who can delete their own messages**.
- Configure **Time limit for deleting messages**.
{!save-changes.md!} {!save-changes.md!}
@ -85,8 +54,8 @@ have permission to move topics between streams.
## Related articles ## Related articles
* [Edit or delete a message](/help/edit-or-delete-a-message)
* [Delete a topic](/help/delete-a-topic)
* [Disable message edit history](/help/disable-message-edit-history) * [Disable message edit history](/help/disable-message-edit-history)
* [Configure message retention policy](/help/message-retention-policy) * [Configure message retention policy](/help/message-retention-policy)
* [Move content to another stream](/help/move-content-to-another-stream) * [Restrict moving messages](/help/configure-who-can-edit-topics)
* [Rename a topic](/help/rename-a-topic)
* [Restrict topic editing](/help/configure-who-can-edit-topics)

View File

@ -1,27 +1,77 @@
# Restrict topic editing # Restrict moving messages
{!admin-only.md!} {!admin-only.md!}
By default, anyone can edit any message topic. This is useful because it allows Zulip lets you configure which [roles](/help/roles-and-permissions) can edit
the community to keep conversations organized, even if some members are still message topics and move topics between streams. In general, allowing all
learning how to use topics effectively. However, you can restrict the ability to organization members to edit message topics is highly recommended because:
edit the topic of any message to specific [roles](/help/roles-and-permissions).
Note that users may still be able to edit the topic of messages with - It allows the community to keep conversations organized, even if some members
**(no topic)**; see the full article on [message and topic are still learning how to use topics effectively.
editing](/help/configure-message-editing-and-deletion) for details. - It lets users [resolve topics](/help/resolve-a-topic).
- It makes it possible to fix a typo in the topic of a message you just sent.
Also, only administrators and moderators can edit the topics of You can let users edit topics without a time limit, or prohibit topic editing on
messages that were sent more than 3 days ago, regardless of the value older messages to avoid potential abuse. The time limit will never apply to
of this setting. administrators and moderators.
### Change who can edit topics Permissions for moving messages between streams can be configured separately.
## Configure who can edit topics
!!! tip ""
Anyone can add a topic to messages sent without a topic.
{start_tabs} {start_tabs}
{settings_tab|organization-permissions} {settings_tab|organization-permissions}
2. Under **Message and topic editing**, configure **Who can edit the topic of any message**. 1. Under **Moving messages**, configure **Who can move messages to another
topic**.
{!save-changes.md!}
{end_tabs}
## Set a time limit for editing topics
!!! tip ""
The time limit you set will not apply to administrators and moderators.
{start_tabs}
{settings_tab|organization-permissions}
1. Under **Moving messages**, configure **Time limit for editing topics**.
{!save-changes.md!}
{end_tabs}
## Configure who can move messages to another stream
{start_tabs}
{settings_tab|organization-permissions}
1. Under **Moving messages**, configure **Who can move messages to another
stream**.
{!save-changes.md!}
{end_tabs}
## Set a time limit for moving messages between streams
!!! tip ""
The time limit you set will not apply to administrators and moderators.
{start_tabs}
{settings_tab|organization-permissions}
1. Under **Moving messages**, configure **Time limit for moving messages
between streams**.
{!save-changes.md!} {!save-changes.md!}
@ -29,7 +79,10 @@ of this setting.
## Related articles ## Related articles
* [Message and topic editing](/help/configure-message-editing-and-deletion)
* [Rename a topic](/help/rename-a-topic) * [Rename a topic](/help/rename-a-topic)
* [Resolve a topic](/help/resolve-a-topic)
* [Move content to another topic](/help/move-content-to-another-topic) * [Move content to another topic](/help/move-content-to-another-topic)
* [Move content to another stream](/help/move-content-to-another-stream)
* [Restrict message editing and
deletion](/help/configure-message-editing-and-deletion)
* [Roles and permissions](/help/roles-and-permissions) * [Roles and permissions](/help/roles-and-permissions)

View File

@ -22,4 +22,4 @@ also disable viewing of message edit history more generally.
## Related articles ## Related articles
* [Restrict message editing](/help/configure-message-editing-and-deletion) * [Restrict message editing and deletion](/help/configure-message-editing-and-deletion)

View File

@ -97,4 +97,4 @@ permissions to delete that message.
* [Delete a topic](/help/delete-a-topic) * [Delete a topic](/help/delete-a-topic)
* [Archive a stream](/help/archive-a-stream) * [Archive a stream](/help/archive-a-stream)
* [Message retention policy](/help/message-retention-policy) * [Message retention policy](/help/message-retention-policy)
* [Configure editing and deletion policies](/help/configure-message-editing-and-deletion) * [Restrict message editing and deletion](/help/configure-message-editing-and-deletion)

View File

@ -107,7 +107,7 @@ keep in mind about the import process:
workspace settings, so you will need to [configure the settings for your Zulip workspace settings, so you will need to [configure the settings for your Zulip
organization](/help/customize-organization-settings). This includes settings organization](/help/customize-organization-settings). This includes settings
like [email visibility](/help/restrict-visibility-of-email-addresses), like [email visibility](/help/restrict-visibility-of-email-addresses),
[message editing permissions](/help/configure-message-editing-and-deletion#configure-message-editing-and-deletion_1), [message editing permissions](/help/configure-message-editing-and-deletion),
and [how users can join your organization](/help/restrict-account-creation). and [how users can join your organization](/help/restrict-account-creation).
- Gitter's export tool does not export user settings, so users in your organization - Gitter's export tool does not export user settings, so users in your organization
@ -143,10 +143,10 @@ Once the import process is completed, you will need to:
1. [Configure the settings for your organization](/help/customize-organization-settings), 1. [Configure the settings for your organization](/help/customize-organization-settings),
which are not exported. This includes settings like [email which are not exported. This includes settings like [email
visibility](/help/restrict-visibility-of-email-addresses), [message editing visibility](/help/restrict-visibility-of-email-addresses), [message editing
permissions](/help/configure-message-editing-and-deletion#configure-message-editing-and-deletion_1), permissions](/help/configure-message-editing-and-deletion),
and [how users can join your organization](/help/restrict-account-creation). and [how users can join your organization](/help/restrict-account-creation).
1. [Configure user roles](/help/change-a-users-role). Only organization owners 2. [Configure user roles](/help/change-a-users-role). Only organization owners
and administrators can do this. and administrators can do this.
* If you [import into Zulip Cloud](#import-your-data-into-zulip), you will * If you [import into Zulip Cloud](#import-your-data-into-zulip), you will
specify the user whose account will have the owner role when you request the specify the user whose account will have the owner role when you request the
@ -155,15 +155,15 @@ Once the import process is completed, you will need to:
organization owner from the terminal][grant-admin-access] to mark the appropriate organization owner from the terminal][grant-admin-access] to mark the appropriate
users as organization owners. users as organization owners.
1. All users from your previous workspace will have accounts in your new Zulip 3. All users from your previous workspace will have accounts in your new Zulip
organization. However, you will need to let users know about their new organization. However, you will need to let users know about their new
accounts, and [how they will log in for the first time accounts, and [how they will log in for the first time
](#how-users-will-log-in-for-the-first-time). ](#how-users-will-log-in-for-the-first-time).
1. Share the URL for your new Zulip organization, and (recommended) the [Getting 4. Share the URL for your new Zulip organization, and (recommended) the [Getting
started with Zulip guide](/help/getting-started-with-zulip). started with Zulip guide](/help/getting-started-with-zulip).
1. Migrate any [integrations](/integrations). 5. Migrate any [integrations](/integrations).
{end_tabs} {end_tabs}

View File

@ -255,7 +255,7 @@ keep in mind about the import process:
the settings for your Zulip organization](/help/customize-organization-settings). the settings for your Zulip organization](/help/customize-organization-settings).
This includes settings like [email This includes settings like [email
visibility](/help/restrict-visibility-of-email-addresses), visibility](/help/restrict-visibility-of-email-addresses),
[message editing permissions](/help/configure-message-editing-and-deletion#configure-message-editing-and-deletion_1), [message editing permissions](/help/configure-message-editing-and-deletion),
and [how users can join your organization](/help/restrict-account-creation). and [how users can join your organization](/help/restrict-account-creation).
- Mattermost's user roles are mapped to Zulip's [user - Mattermost's user roles are mapped to Zulip's [user

View File

@ -104,7 +104,7 @@ keep in mind about the import process:
the settings for your Zulip organization](/help/customize-organization-settings). the settings for your Zulip organization](/help/customize-organization-settings).
This includes settings like [email This includes settings like [email
visibility](/help/restrict-visibility-of-email-addresses), visibility](/help/restrict-visibility-of-email-addresses),
[message editing permissions](/help/configure-message-editing-and-deletion#configure-message-editing-and-deletion_1), [message editing permissions](/help/configure-message-editing-and-deletion),
and [how users can join your organization](/help/restrict-account-creation). and [how users can join your organization](/help/restrict-account-creation).
- Rocket.Chat does not export user settings, so users in your organization may - Rocket.Chat does not export user settings, so users in your organization may

View File

@ -135,7 +135,7 @@ in mind about the import process:
the settings for your Zulip organization](/help/customize-organization-settings). the settings for your Zulip organization](/help/customize-organization-settings).
This includes settings like [email This includes settings like [email
visibility](/help/restrict-visibility-of-email-addresses), visibility](/help/restrict-visibility-of-email-addresses),
[message editing permissions](/help/configure-message-editing-and-deletion#configure-message-editing-and-deletion_1), [message editing permissions](/help/configure-message-editing-and-deletion),
and [how users can join your organization](/help/restrict-account-creation). and [how users can join your organization](/help/restrict-account-creation).
- Slack does not export user settings, so users in your organization may want to - Slack does not export user settings, so users in your organization may want to

View File

@ -17,12 +17,13 @@ A few settings to highlight:
* [Add custom emoji](/help/custom-emoji), including your organization's logo. * [Add custom emoji](/help/custom-emoji), including your organization's logo.
For many other settings, e.g. [message and topic editing For many other settings, e.g., [message][message-editing-permissions] and
permissions][topic-editing-permissions], you can experience how Zulip [topic][topic-editing-permissions] editing permissions, you can experience how
works for your organization before deciding what settings are best for Zulip works for your organization before deciding what settings are best for
you. you.
[topic-editing-permissions]: /help/configure-message-editing-and-deletion [message-editing-permissions]: /help/configure-message-editing-and-deletion
[topic-editing-permissions]: /help/configure-who-can-edit-topics
[default-code-block-language]: /help/code-blocks#default-code-block-language [default-code-block-language]: /help/code-blocks#default-code-block-language
[code-playgrounds]: /help/code-blocks#code-playgrounds [code-playgrounds]: /help/code-blocks#code-playgrounds
[email-address-visibility]: /help/restrict-visibility-of-email-addresses [email-address-visibility]: /help/restrict-visibility-of-email-addresses

View File

@ -5,17 +5,17 @@ Once the import process is completed, you will need to:
1. [Configure the settings for your organization](/help/customize-organization-settings), 1. [Configure the settings for your organization](/help/customize-organization-settings),
which are not exported. This includes settings like [email which are not exported. This includes settings like [email
visibility](/help/restrict-visibility-of-email-addresses), [message editing visibility](/help/restrict-visibility-of-email-addresses), [message editing
permissions](/help/configure-message-editing-and-deletion#configure-message-editing-and-deletion_1), permissions](/help/configure-message-editing-and-deletion),
and [how users can join your organization](/help/restrict-account-creation). and [how users can join your organization](/help/restrict-account-creation).
1. All users from your previous workspace will have accounts in your new Zulip 2. All users from your previous workspace will have accounts in your new Zulip
organization. However, you will need to let users know about their new organization. However, you will need to let users know about their new
accounts, and [decide how they will log accounts, and [decide how they will log
in](/help/import-from-slack#decide-how-users-will-log-in) for the first time. in](/help/import-from-slack#decide-how-users-will-log-in) for the first time.
1. Share the URL for your new Zulip organization, and (recommended) the [Getting 3. Share the URL for your new Zulip organization, and (recommended) the [Getting
started with Zulip guide](/help/getting-started-with-zulip). started with Zulip guide](/help/getting-started-with-zulip).
1. Migrate any [integrations](/integrations). 4. Migrate any [integrations](/integrations).
{end_tabs} {end_tabs}

View File

@ -189,7 +189,7 @@
* [Require topics in stream messages](/help/require-topics) * [Require topics in stream messages](/help/require-topics)
* [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)
* [Restrict topic editing](/help/configure-who-can-edit-topics) * [Restrict moving messages](/help/configure-who-can-edit-topics)
* [Restrict message editing](/help/configure-message-editing-and-deletion) * [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)
* [Block image and link previews](/help/allow-image-link-previews) * [Block image and link previews](/help/allow-image-link-previews)

View File

@ -1,9 +1,11 @@
# Move content to another stream # Move content to another stream
Zulip makes it possible to move messages, or an entire topic, to another Zulip makes it possible to move messages, or an entire topic, to another stream.
stream. Organizations can [configure][move-permission-setting] which Organizations can [configure][configure-moving-permissions] which
[roles](/help/roles-and-permissions) have permission to move messages [roles](/help/roles-and-permissions) have permission to move messages between
between streams. streams.
[configure-moving-permissions]: /help/configure-who-can-edit-topics#configure-who-can-move-messages-to-another-stream
To help others find moved content, you can have the [notification To help others find moved content, you can have the [notification
bot][notification-bot] send automated notices to the source topic, the bot][notification-bot] send automated notices to the source topic, the
@ -104,7 +106,6 @@ that one does not have permission to access.
* [Rename a topic](/help/rename-a-topic) * [Rename a topic](/help/rename-a-topic)
* [Move content to another topic](/help/move-content-to-another-topic) * [Move content to another topic](/help/move-content-to-another-topic)
* [Configure message editing and deletion](/help/configure-message-editing-and-deletion) * [Restrict moving messages](/help/configure-who-can-edit-topics)
[move-permission-setting]: /help/configure-message-editing-and-deletion#configure-who-can-move-topics-between-streams
[notification-bot]: /help/configure-notification-bot [notification-bot]: /help/configure-notification-bot

View File

@ -12,9 +12,7 @@ topics](/help/mute-a-topic) are automatically migrated when an entire
topic is moved. topic is moved.
Organizations can [configure](/help/configure-who-can-edit-topics) which Organizations can [configure](/help/configure-who-can-edit-topics) which
[roles](/help/roles-and-permissions) have permission to modify topics. See the [roles](/help/roles-and-permissions) have permission to modify topics.
[guide to message and topic editing](/help/configure-message-editing-and-deletion)
for the details on when topic editing is allowed.
## Move messages to another topic ## Move messages to another topic
@ -39,4 +37,4 @@ for the details on when topic editing is allowed.
* [Rename a topic](/help/rename-a-topic) * [Rename a topic](/help/rename-a-topic)
* [Move content to another stream](/help/move-content-to-another-stream) * [Move content to another stream](/help/move-content-to-another-stream)
* [Configure message editing and deletion](/help/configure-message-editing-and-deletion) * [Restrict moving messages](/help/configure-who-can-edit-topics)

View File

@ -11,9 +11,7 @@ will automatically redirect to the new location of the message. [Muted
topics](/help/mute-a-topic) are automatically migrated when a topic is renamed. topics](/help/mute-a-topic) are automatically migrated when a topic is renamed.
Organizations can [configure](/help/configure-who-can-edit-topics) which Organizations can [configure](/help/configure-who-can-edit-topics) which
[roles](/help/roles-and-permissions) have permission to rename topics. See the [roles](/help/roles-and-permissions) have permission to rename topics.
[guide to message and topic editing](/help/configure-message-editing-and-deletion)
for the details on when topic editing is allowed.
## Rename a topic ## Rename a topic
@ -48,10 +46,10 @@ for the details on when topic editing is allowed.
{end_tabs} {end_tabs}
[move-permission-setting]: /help/configure-message-editing-and-deletion#configure-who-can-move-topics-between-streams
## Related articles ## Related articles
* [Move content to another topic](/help/move-content-to-another-topic) * [Move content to another topic](/help/move-content-to-another-topic)
* [Move content to another stream](/help/move-content-to-another-stream) * [Move content to another stream](/help/move-content-to-another-stream)
* [Resolve a topic](/help/resolve-a-topic) * [Resolve a topic](/help/resolve-a-topic)
* [Restrict moving messages](/help/configure-who-can-edit-topics)

View File

@ -23,7 +23,6 @@ specified topic.
If a user sends a message without a topic, the message's topic is If a user sends a message without a topic, the message's topic is
displayed as **(no topic)**. displayed as **(no topic)**.
When [message editing](/help/configure-message-editing-and-deletion) Any user can [add a topic](/help/rename-a-topic) to messages without a topic.
is enabled, any user can [add a topic](/help/rename-a-topic) They can do so regardless of whether they can [edit topics in
to messages without a topic. They can do so regardless of whether general](/help/configure-who-can-edit-topics).
they can [edit topics in general](/help/configure-who-can-edit-topics).

View File

@ -37,10 +37,7 @@ approaches for deciding when to mark a topic as resolved:
Users can resolve and unresolve a topic if they have permission to edit Users can resolve and unresolve a topic if they have permission to edit
topics. Organization administrators can [configure who can edit topics. Organization administrators can [configure who can edit
topics](/help/configure-who-can-edit-topics) or turn off message topics](/help/configure-who-can-edit-topics).
editing entirely. See the [guide to message and topic
editing](/help/configure-message-editing-and-deletion) for details
on when topic editing is allowed.
## Mark a topic as resolved ## Mark a topic as resolved
@ -111,5 +108,4 @@ on when topic editing is allowed.
* [Rename a topic](/help/rename-a-topic) * [Rename a topic](/help/rename-a-topic)
* [Move content to another topic](/help/move-content-to-another-topic) * [Move content to another topic](/help/move-content-to-another-topic)
* [Restrict topic editing](/help/configure-who-can-edit-topics) * [Restrict topic editing](/help/configure-who-can-edit-topics)
* [Configure message editing and deletion](/help/configure-message-editing-and-deletion)
* [API documentation for resolving topics](/api/update-message) * [API documentation for resolving topics](/api/update-message)

View File

@ -167,7 +167,7 @@ how to assign roles and permissions for a class.
(Recommended: Admins for public streams; Admins, moderators and members for private streams) (Recommended: Admins for public streams; Admins, moderators and members for private streams)
- Set [who can add users to streams](/help/configure-who-can-invite-to-streams). - Set [who can add users to streams](/help/configure-who-can-invite-to-streams).
(Recommended: Admins and moderators) (Recommended: Admins and moderators)
- Set [who can edit the topic of any message](/help/configure-who-can-invite-to-streams). - Set [who can edit the topic of any message](/help/configure-who-can-edit-topics).
(Recommended: (default) Members for small classes; (Recommended: (default) Members for small classes;
Admins and moderators for large classes) Admins and moderators for large classes)
- Set [who can move messages between streams][move-between-streams]. - Set [who can move messages between streams][move-between-streams].
@ -176,7 +176,7 @@ how to assign roles and permissions for a class.
(Recommended: Admins and moderators) (Recommended: Admins and moderators)
[user-group-permissions]: /help/user-groups#configure-who-can-create-and-manage-user-groups [user-group-permissions]: /help/user-groups#configure-who-can-create-and-manage-user-groups
[move-between-streams]: /help/configure-message-editing-and-deletion#configure-who-can-move-topics-between-streams [move-between-streams]: /help/configure-who-can-edit-topics#configure-who-can-move-messages-to-another-stream
#### Recommended roles and permissions for a department #### Recommended roles and permissions for a department
@ -198,7 +198,7 @@ how to assign roles and permissions for a class.
Admins, moderators and members for private streams) Admins, moderators and members for private streams)
- Set [who can add users to streams](/help/configure-who-can-invite-to-streams). - Set [who can add users to streams](/help/configure-who-can-invite-to-streams).
(Recommended: Admins and moderators) (Recommended: Admins and moderators)
- Set [who can edit the topic of any message](/help/configure-who-can-invite-to-streams). - Set [who can edit the topic of any message](/help/configure-who-can-edit-topics).
(Recommended: Admins and moderators) (Recommended: Admins and moderators)
- Set [who can move messages between streams][move-between-streams]. - Set [who can move messages between streams][move-between-streams].
(Recommended: Admins and moderators) (Recommended: Admins and moderators)

View File

@ -38,5 +38,5 @@ Organization administrators can
## Related articles ## Related articles
* [Restrict message editing](/help/configure-message-editing-and-deletion) * [Restrict message editing and deletion](/help/configure-message-editing-and-deletion)
* [Disable message edit history](/help/disable-message-edit-history) * [Disable message edit history](/help/disable-message-edit-history)