mirror of
https://github.com/matrix-org/matrix-spec
synced 2026-01-28 10:03:43 +01:00
1f6b12b3e8
Convert the file format to be of the form ##_##_something.rst where the first ## is the top-level section number and the second ## is the second-level section number, e.g. 07_01_push_cs_api.rst means Section 7.1 - This is now enforced in gendoc.py along with the title line style that should be used (= for top-level, - for 2nd level) which will give helpful suggestions if you trip up. This feels much more intuitive now looking in /specification
25 lines
809 B
ReStructuredText
25 lines
809 B
ReStructuredText
Room History Visibility
|
|
-----------------------
|
|
|
|
Whether a member of a room can see the events that happened in a room from
|
|
before they joined the room is controlled by the ``history_visibility`` key
|
|
of the ``m.room.history_visibility`` state event. The valid values for
|
|
``history_visibility`` are:
|
|
|
|
- ``shared``
|
|
- ``invited``
|
|
- ``joined``
|
|
|
|
By default if no ``history_visibility`` is set it is assumed to be ``shared``.
|
|
|
|
The rules governing whether a user is allowed to see an event depend solely on
|
|
the state of the room at that event:
|
|
|
|
1. If the user was joined, allow.
|
|
2. If the user was invited and the ``history_visibility`` was set to
|
|
``invited`` or ``shared``, allow.
|
|
3. If the user was neither invited nor joined but the ``history_visibility``
|
|
was set to ``shared``, allow.
|
|
4. Otherwise, deny.
|
|
|