diff --git a/docs/guides/matrix-create-room.md b/docs/guides/matrix-create-room.md new file mode 100644 index 00000000..d43f6140 --- /dev/null +++ b/docs/guides/matrix-create-room.md @@ -0,0 +1,53 @@ +--- +title: "Matrix: Create a New Room" +--- + +# Matrix: Create a New Room + +!!! success "Goal" + + Create a new matrix room for a CCCHH group or function with correct protections and permissions + +## 1. Create the Room + +Rooms are always created by the *CCCHH-Admin* Account whose credentials can be found in *infra-secrets*. +To create a room, log in to https://element.hamburg.ccc.de and click on *New Conversation* -> *New Room*. +Enter a Room Name and optionally give it an address on the *hamburg.ccc.de* server. + +## 2. Configure Room Metadata + +Once the room is created, please give it a topic and if possible a room icon. +This makes it easier to distinguish the many rooms we have. + +## 3. Invite the Moderation-Bot + +Either perform the following steps via the GUI or enter the displayed commands into the chat window of the new room: + + +1. Invite the User `@moderation:hamburg.ccc.de` to the new room + ``` + /invite @moderation:hamburg.ccc.de + ``` + +2. Give the moderation bot *Admin* Power-Level so that it can properly enforce all protections + ``` + /op @moderation:hamburg.ccc.de 100 + ``` + +## 4. Set Up Room Protection + +We have now added the moderation bot to the room but this is not enough. +The bot needs to be told explicitly which rooms it should protect and the newly created one therefore needs to be added to that list. + +First, note down the *Internal Room ID* which can be found in the new Rooms settings under the *Advanced* tab. +Then enter the *CCCHH Moderation Management* room and write the follogin mjolnir command while substituting the copied room id: + +``` +!mjolnir rooms add +``` + +## Closing Up + +You should now have a new Matrix Room under moderation protection. +To verify that everything was done correctly, you can enter `!mjolnir verify` in the *CCCHH Moderation Management* room and observe that the moderation bot does not give you an error. +