diff --git a/docs/concepts-and-configurations/matrix-moderation.md b/docs/concepts-and-configurations/matrix-moderation.md index d37c507e..159fbb49 100644 --- a/docs/concepts-and-configurations/matrix-moderation.md +++ b/docs/concepts-and-configurations/matrix-moderation.md @@ -15,7 +15,7 @@ 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). +- Prohibited content includes spam, pornography, harassment, and fascist-like behavior. We remove such content and subsequently ban the user responsible (see [Matrix: Taking Moderation Action](../guides/matrix-taking-moderation-action.md)). - The CCCHH admin account may be used under special circumstances to issue warnings and explain the moderation team’s 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. diff --git a/docs/guides/matrix-taking-moderation-action.md b/docs/guides/matrix-taking-moderation-action.md new file mode 100644 index 00000000..b1bf69fd --- /dev/null +++ b/docs/guides/matrix-taking-moderation-action.md @@ -0,0 +1,52 @@ +--- +title: "Matrix: Taking Moderation Action" +--- + +!!! success "Goal" + + Perform common moderation actions in Matrix using our moderation bot + +See the [Matrix-Moderation](../concepts-and-configurations/matrix-moderation.md) Concept for an overview on how the moderation system functions. + +All bot actions are triggered through the *CCCHH Moderation Management* room. + +!!! warning "Warning" + + Moderation actions should be triggered through the bot to avoid exposing members of the moderation team to harassment. + Even if the bot is unwieldy, think before taking action with your personal account and do so on your own scrutiny. + +## Banning a User + +``` +!mjolnir ban general user +``` + +- `` can be a user ID (e.g. `@example:matrix.org`) but also more sophisticated. Be careful when using actual glob syntax as whole servers can be banned even if just a single user is the intended target. +- `` is technically optional but should always be supplied so that we know why a certain user was banned in retrospect. The bot supports parsing quotations so `""` is usually what you want if more than one word is used. + +## Banning a Server + +``` +!mjolnir ban server +``` + +- `` can be used to ban subdomains of a domain too, e.g. `*.example.com`. If used, an additional `--force` is required after the whole command. +- `` should be supplied and supports quotation (`"") if more than one word is used +- When a domain is banned, we usually also ban all subdomains too. This needs to be done in two separate commands. + +## Redacting a single Message + +``` +!mjolnir redact +``` + +- `` is **not** the message ID but the actual *https://matrix.to/#blablabla* link that can be retrieved with most clients through a *Share* or *Copy link to Message* button on an individual message. + +## Redacting all Messages of a User + +``` +!mjolnir redact +``` + +- `user-id` the Matrix-ID of the user of whom all messages in all rooms should be redacted (e.g. `@bla:example.com`). +