From 8ece64187a850f96ccde11dcb98fcf31591039a6 Mon Sep 17 00:00:00 2001
From: Aminda Suomalainen <suomalainen+git@mikaela.info>
Date: Wed, 7 Jun 2023 11:47:13 +0300
Subject: [PATCH] m.room.history_visibility/README.md: initial commit

---
 matrix/m.room.history_visibility/README.md | 43 ++++++++++++++++++++++
 1 file changed, 43 insertions(+)
 create mode 100644 matrix/m.room.history_visibility/README.md

diff --git a/matrix/m.room.history_visibility/README.md b/matrix/m.room.history_visibility/README.md
new file mode 100644
index 0000000..d9014db
--- /dev/null
+++ b/matrix/m.room.history_visibility/README.md
@@ -0,0 +1,43 @@
+# `m.room.history_visibility`
+
+`m.room.history_visibility` controls who can view the room history.
+
+<!-- prettier-ignore-start -->
+
+<!-- START doctoc generated TOC please keep comment here to allow auto update -->
+<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
+
+- [Example](#example)
+- [Options](#options)
+- [See also](#see-also)
+
+<!-- END doctoc generated TOC please keep comment here to allow auto update -->
+
+<!-- prettier-ignore-end -->
+
+## Example
+
+```json
+{
+  "history_visibility": "invited"
+}
+```
+
+## Options
+
+[Refer to the upstream for canonical information.](https://spec.matrix.org/latest/client-server-api/#room-history-visibility)
+
+- `world_readable` - anyone can read the history without joining, and it
+  likely will be indexed by search engines.
+- `shared` - history is shared to all users in the room, regardless of when
+  they joined.
+  - [Matrix public archive will publish history of rooms with this option although not allow search engines to index.](https://github.com/matrix-org/matrix-public-archive/blob/main/docs/faq.md#why-does-the-archive-user-join-rooms-instead-of-browsing-them-as-a-guest)
+- `invited` - users can see history from the point of time they were invited
+  to the room. **_RECOMMENDED FOR SEMI-PUBLIC ROOMS_**
+- `joined` users can see history from the point of time they joined
+
+**_WARNING!_** Changing the option **will not affect old messages**.
+
+## See also
+
+- `m.room.join_rules`