m.room.join_rules/README.md: see also m.room.history.visibility

.pre-commit-config.yaml

@@ -34,7 +34,7 @@ repos:
         args: [--update-only, --notitle]
 
   - repo: https://github.com/python-jsonschema/check-jsonschema
-    rev: 0.23.0
+    rev: 0.23.1
     hooks:
       #- id: check-dependabot
       #- id: check-github-actions

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`

matrix/m.room.join_rules/README.md

@@ -6,6 +6,7 @@
   - [membership of another room](#membership-of-another-room)
     - [merging knocking and membership of another room](#merging-knocking-and-membership-of-another-room)
   - [Note to self](#note-to-self)
+  - [See also](#see-also)
 
 <!-- END doctoc generated TOC please keep comment here to allow auto update -->
 
@@ -131,3 +132,7 @@ Practically the same, but requires room version 10 and new `join_rule` known as
 - `!iQaStEQNwaqxQfyhZi:sorunome.de` - FluffyChat Space v6
 - `!ESKEvwumMpSRZTnJOI:pikaviestin.fi` - Piraattipuolue v10
 - `!azROMLeGEMPdbdWnbk:matrix.org` - Piraattipuolueen työrauha v9
+
+## See also
+
+- `m.room.history_visibility`