Add documentation around our matrix moderation setup #151

Merged
bitwhisker merged 3 commits from lilly/matrix-docs into main 2026-09-05 23:29:09 +02:00
Showing only changes of commit 70cc70abf4 - Show all commits

add concept doc for matrix moderation

lilly 2026-09-02 11:01:50 +02:00
Signed by: lilly
SSH key fingerprint: SHA256:y9T5GFw2A20WVklhetIxG1+kcg/Ce0shnQmbu1LQ37g

View file

@ -0,0 +1,35 @@
---
title: Matrix Moderation
---
# Matrix Moderation
All Matrix rooms created around CCCHH and which are considered *official* are subject to centralized moderation.
This moderation is enforced by a [Mjolnir](https://github.com/matrix-org/mjolnir) bot on a techincal level and operated by a dedicated sub-team of the Infra Group.
The moderation team can be reached at [matrix-moderation@hamburg.ccc.de](mailto:matrix-moderation@hamburg.ccc.de).
## Principles and Guidelines
During moderation, we adhere to the following principles:
- No *predictive policing*. We strive for fast and accurate moderation and, while we do incorporate reports from trustworthy sources close to the chaos community, we do not moderate based on gut feelings.
- Prohibited content includes spam, pornography, harassment, and fascist-like behavior. We remove such content (see Guide TODO) and subsequently ban the user responsible (see Guide TODO).
- The CCCHH admin account may be used under special circumstances to issue warnings and explain the moderation teams decisions in general terms. It does not respond to DMs and does not engage in discussions. If moderation action is to be discussed, people are referred to the moderation team at [matrix-moderation@hamburg.ccc.de](mailto:matrix-moderation@hamburg.ccc.de) instead.
- New Matrix rooms related to CCCHH are **always** created by the CCCHH admin and protected by the moderation bot. See [Matrix: Create a New Room](../guides/matrix-create-room.md) for details on creating rooms.
lilly marked this conversation as resolved

please only do relative or absolute reverences of other docs (2/3)

please only do relative or absolute reverences of other docs (2/3)
## How It Works
The bot account `@moderation:hamburg.ccc.de` (Mjolnir) maintains various internal lists of rules that are applied in so-called "Protected Rooms".
These can include, for example, user bans or entire server bans.
Additionally, certain automatic monitoring measures (so-called "protections") apply in these rooms, which trigger a configured action if violated.
For example, a user is not allowed to tag too many other users in a single message, as this is considered spam and results in a kick.
The bot is controlled and configured via a privileged *CCCHH Moderation Management* room using `!mjolnir` commands.
There, individual actions can also be triggered through the bot as needed, such as redacting messages, kicking users from all or some channels, etc.
It is also possible to make our moderation bot's local lists available to other entities and subscribe our bot to other entities' lists.
Our list is published in `#general-moderation:hamburg.ccc.de` and can be made available to others upon request.