Mirror
/
zulip
mirror of https://github.com/zulip/zulip.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
zulip/templates/zerver/help/edit-or-delete-a-message.md

103 lines
3.7 KiB
Markdown
Raw Normal View History

user docs: Make minor edits to *Edit or delete a message* doc.
2017-02-04 03:47:15 +01:00
# Edit or delete a message
Add user guide for *Editing past messages*.
2016-11-30 21:44:07 +01:00
docs: Add macros to the *Edit or delete a message* doc.
2017-01-05 19:59:33 +01:00
!!! warn ""
help: Add newline after admonition header for Prettier compatibility. Signed-off-by: Anders Kaseorg <anders@zulip.com>
2021-09-10 00:44:29 +02:00
help: Update edit-or-delete-a-message.
2019-02-13 21:59:11 +01:00
**Note:** Editing message topic is discussed in a
help: Reorganize articles on editing topics. * Move content on moving topics between streams to a dedicated article. We advertise it as "move content" to hint that one can move messages or split topics, and link to it. * This deletes change-the-topic-of-a-message, because the same content is already covered in rename-a-topic. * This commit mostly just moves content between articles. Most of that content was redundant with the first few paragraphs of the surviving "rename a topic" article. The former "This is useful for" se ntence was adapted to the remaining article. * This commit also adds a redirect for the removed article, and updates related links.
2021-06-22 16:21:15 +02:00
[separate guide](/help/rename-a-topic).
Add user guide for *Editing past messages*.
2016-11-30 21:44:07 +01:00
help: Fix a few errors in edit-or-delete-a-message.md. Still some errors (e.g. "Hover over a message to replace the message's timestamp with its message actions" is no longer correct), and a lot of other improvements to be made, but just doing a quick fix of a few things I noticed.
2018-03-30 19:55:15 +02:00
By default, Zulip allows you to edit the content of your messages within 10
help: Update edit-or-delete-a-message.
2019-02-13 21:59:11 +01:00
minutes of when you send them. Organization administrators can
[change the time limit](/help/configure-message-editing-and-deletion),
remove the time limit, or remove the ability to edit messages entirely.
Administrators can delete other users' messages, but can never edit the
content.
## Edit a message
{start_tabs}
Add user guide for *Editing past messages*.
2016-11-30 21:44:07 +01:00
user docs: Update the message-actions macro.
2018-09-16 17:31:07 +02:00
{!message-actions.md!}
user docs: Remove icon-vector for font-awesome.
2018-10-09 21:39:41 +02:00
1. Click the pencil (<i class="fa fa-pencil"></i>) icon.
Add user guide for *Editing past messages*.
2016-11-30 21:44:07 +01:00
help: Update edit-or-delete-a-message.
2019-02-13 21:59:11 +01:00
1. Edit the message, and click **Save**.
{end_tabs}
Add user guide for *Editing past messages*.
2016-11-30 21:44:07 +01:00
docs: Add macros to the *Edit or delete a message* doc.
2017-01-05 19:59:33 +01:00
!!! warn ""
help: Add newline after admonition header for Prettier compatibility. Signed-off-by: Anders Kaseorg <anders@zulip.com>
2021-09-10 00:44:29 +02:00
help_docs: Update edit history documentation for messages. `disable-message-edit-history`: Remove text about EDITED label and link to `view-a-messages-edit-history` instead. `edit-or-delete-a-message`: Reformat 'EDITED' and '(deleted)' to be bold instead of using backticks. Make link to view edit history clearer. Note that the text used in the `OpenGraphTest` in `test_middleware.py` had to be updated for the changes to `disable-message-edit-history`.
2022-03-23 14:05:07 +01:00
**Note:** After you have edited a message, the message is publicly
marked as **EDITED**. You can
[view a message's edit history](/help/view-a-messages-edit-history),
assuming that feature has not been
docs: Document disabling message edit history.
2017-07-16 19:11:12 +02:00
[disabled by an organization administrator](/help/disable-message-edit-history).
Add user guide for *Editing past messages*.
2016-11-30 21:44:07 +01:00
help: Update edit-or-delete-a-message.
2019-02-13 21:59:11 +01:00
If you don't see the pencil (<i class="fa fa-pencil"></i>) icon, the message content
icons: Switch from text-o to code-o for view source / edit topics. This commit replaces fa-file-text-o with fa-file-code-o which is a better signal for the "view source" action. It also deletes a single line comment that had suggested the change once we moved into font awesome 4, which Aditya Bansal <adi.bansal241996@gmail.com> helped out in doing, first via 91962aa6ab9cdbca483313efc92c59053c397623 and most recently via 75ae94e4597270b54712f63bd621a3ac540b8205 with several commits in between.
2020-05-21 08:20:49 +02:00
can no longer be edited. You should see a file (<i class="fa fa-file-code-o"></i>)
help: Update edit-or-delete-a-message.
2019-02-13 21:59:11 +01:00
icon instead. Clicking the file icon will allow you to view the
[Markdown source](/help/view-the-markdown-source-of-a-message) of the message, or
help: Reorganize articles on editing topics. * Move content on moving topics between streams to a dedicated article. We advertise it as "move content" to hint that one can move messages or split topics, and link to it. * This deletes change-the-topic-of-a-message, because the same content is already covered in rename-a-topic. * This commit mostly just moves content between articles. Most of that content was redundant with the first few paragraphs of the surviving "rename a topic" article. The former "This is useful for" se ntence was adapted to the remaining article. * This commit also adds a redirect for the removed article, and updates related links.
2021-06-22 16:21:15 +02:00
[edit the topic](/help/rename-a-topic).
Add user guide for *Editing past messages*.
2016-11-30 21:44:07 +01:00
help: Update edit-or-delete-a-message.
2019-02-13 21:59:11 +01:00
## Delete a message
Add user guide for *Editing past messages*.
2016-11-30 21:44:07 +01:00
docs: Improve linking of documentation around message deletion. This should help users confirm their understanding of how deletion works in Zulip starting from the actual deletion UI.
2020-10-30 01:08:36 +01:00
Editing a message to delete its content will cause the message to be
help_docs: Update edit history documentation for messages. `disable-message-edit-history`: Remove text about EDITED label and link to `view-a-messages-edit-history` instead. `edit-or-delete-a-message`: Reformat 'EDITED' and '(deleted)' to be bold instead of using backticks. Make link to view edit history clearer. Note that the text used in the `OpenGraphTest` in `test_middleware.py` had to be updated for the changes to `disable-message-edit-history`.
2022-03-23 14:05:07 +01:00
displayed as **(deleted)**. The original sender and timestamp of the
docs: Improve linking of documentation around message deletion. This should help users confirm their understanding of how deletion works in Zulip starting from the actual deletion UI.
2020-10-30 01:08:36 +01:00
message will still be displayed, and the original content of the
message is still accessible via Zulip's [edit
history](/help/view-a-messages-edit-history) feature. This can be the
least confusing option for other users.
help: Add documentation on deleting a message. Fixes #5393.
2017-07-14 17:00:14 +02:00
### Delete a message completely
help: Fix a few errors in edit-or-delete-a-message.md. Still some errors (e.g. "Hover over a message to replace the message's timestamp with its message actions" is no longer correct), and a lot of other improvements to be made, but just doing a quick fix of a few things I noticed.
2018-03-30 19:55:15 +02:00
For cases where someone accidentally shared secret information publicly
(e.g. you posted an employee's salary), it can make sense to delete a
help: Update edit-or-delete-a-message.
2019-02-13 21:59:11 +01:00
message completely.
help: Add documentation on deleting a message. Fixes #5393.
2017-07-14 17:00:14 +02:00
help: Update edit-or-delete-a-message.
2019-02-13 21:59:11 +01:00
By default, only administrators can delete messages, though this can be
[configured](/help/configure-message-editing-and-deletion) by an organization
administrator.
help: Fix a few errors in edit-or-delete-a-message.md. Still some errors (e.g. "Hover over a message to replace the message's timestamp with its message actions" is no longer correct), and a lot of other improvements to be made, but just doing a quick fix of a few things I noticed.
2018-03-30 19:55:15 +02:00
help: Update edit-or-delete-a-message.
2019-02-13 21:59:11 +01:00
{start_tabs}
help: Add documentation on deleting a message. Fixes #5393.
2017-07-14 17:00:14 +02:00
user docs: Add the message-actions-menu macro.
2018-09-16 17:23:45 +02:00
{!message-actions-menu.md!}
help: Add documentation on deleting a message. Fixes #5393.
2017-07-14 17:00:14 +02:00
help: Update edit-or-delete-a-message.
2019-02-13 21:59:11 +01:00
1. Select **Delete message**.
docs: Fix typos in user docs. Fixes #18294.
2021-05-05 16:38:36 +02:00
1. Approve by clicking **Confirm**.
help: Update edit-or-delete-a-message.
2019-02-13 21:59:11 +01:00
{end_tabs}
help: Fix a few errors in edit-or-delete-a-message.md. Still some errors (e.g. "Hover over a message to replace the message's timestamp with its message actions" is no longer correct), and a lot of other improvements to be made, but just doing a quick fix of a few things I noticed.
2018-03-30 19:55:15 +02:00
If you don't see the **Delete message** option, it means you don't have
permissions to delete that message.
docs: Document message retention policies. We've completed the production performance testing that had been blocking us from advertising this feature, so we're declaring the feature implemented by documenting it. As of this commit, you need to edit fields using `manage.py shell` to configure it and manually configure the cron job, but those should be addressed in the next few days. Fixes #106.
2020-05-04 08:38:54 +02:00
## How deletion works
* Deleted messages will immediately disappear from the UI in all
official Zulip clients.
* Any uploaded files referenced only by deleted messages will also be
immediately inaccessible (An uploaded file shared in multiple
messages will not be deleted until all of those messages are
deleted).
* It's important to understand that anyone who received the message
before you deleted it could have made a copy of its content. Even if
no one is online when you send the message, users may have received
the message via email or mobile notifications. So if you
accidentally shared secret information that you can change, like a
password, you may want to change that password regardless of whether
you also delete the message.
* For protection against accidental or immediately regretted
deletions, messages deleted directly or via a [message retention
deletion: Preserve deleted objects for 30 days rather than 7. We had an incident where someone didn't notice for a week that they'd accidentally enabled a 30-day message retention policy, and thus we were unable to restore the deleted the content. After some review of what other products do (E.g. Dropbox preserves things in a restoreable state for 30 days) we're adjusting this setting's default value to be substantially longer, to give more time for users to notice their mistake and correct it before data is irrevocably deleted.
2021-11-18 02:24:40 +01:00
policy](/help/message-retention-policy) are archived for 30 days in a
help: Clarify only server administrators can restore deletions.
2020-05-07 00:54:42 +02:00
format that can be restored by a server administrator. After that
time, they are permanently and irrecoverably deleted from the Zulip
server. Server administrators can adjust the archival time using
the `ARCHIVED_DATA_VACUUMING_DELAY_DAYS` setting.
docs: Document message retention policies. We've completed the production performance testing that had been blocking us from advertising this feature, so we're declaring the feature implemented by documenting it. As of this commit, you need to edit fields using `manage.py shell` to configure it and manually configure the cron job, but those should be addressed in the next few days. Fixes #106.
2020-05-04 08:38:54 +02:00
## Related articles
* [Delete a topic](/help/delete-a-topic)
streams: Use "archive stream" phrasing instead of "delete stream". The previous phrasing was misleading in relation to what the action actually does.
2021-03-31 16:15:24 +02:00
* [Archive a stream](/help/archive-a-stream)
docs: Document message retention policies. We've completed the production performance testing that had been blocking us from advertising this feature, so we're declaring the feature implemented by documenting it. As of this commit, you need to edit fields using `manage.py shell` to configure it and manually configure the cron job, but those should be addressed in the next few days. Fixes #106.
2020-05-04 08:38:54 +02:00
* [Message retention policy](/help/message-retention-policy)
docs: Improve linking of documentation around message deletion. This should help users confirm their understanding of how deletion works in Zulip starting from the actual deletion UI.
2020-10-30 01:08:36 +01:00
* [Configure editing and deletion policies](/help/configure-message-editing-and-deletion)