add docs about the matrix instance

.vitepress/config.mts

@@ -55,6 +55,7 @@ export default defineConfig({
       {icon: "signal", link: "https://signal.group/#CjQKIKcj5S25ptG6H9bzdbaeot1_whif9j59J7bOmm91TeTlEhAc-VmeJpTuP-tZuOJad_MT"},
       {icon: "mastodon", link: "https://mastodon.social/@heartofcode@systemli.social"},
       { icon: 'github', link: 'https://github.com/heartsofcode' },
+      { icon: 'matrix', link: 'https://matrix.to/#/#community:matrix.heartofcode.org' },
     ]
   }
 })

contact.md

@@ -10,4 +10,5 @@ Sonst gibt es auch noch:
 
 - Mastodon: [@heartofcode@systemli.social](https://mastodon.social/@heartofcode@systemli.social)
 - Die [Signal-Gruppe](https://signal.group/#CjQKIKcj5S25ptG6H9bzdbaeot1_whif9j59J7bOmm91TeTlEhAc-VmeJpTuP-tZuOJad_MT) für Ankündigungen
-- Den [Kalender](/calendar.md) mit unserem Programm
+- Den [Kalender](/calendar.md) mit unserem Programm
+- Den [Matrix-Space](/matrix.md) für Echtzeitkommunikation

en/contact.md

@@ -10,4 +10,5 @@ There is also:
 
 - Mastodon: [@heartofcode@systemli.social](https://mastodon.social/@heartofcode@systemli.social)
 - Our [Signal group](https://signal.group/#CjQKIKcj5S25ptG6H9bzdbaeot1_whif9j59J7bOmm91TeTlEhAc-VmeJpTuP-tZuOJad_MT) for announcements
-- The [calendar](/calendar.md) with our events
+- The [calendar](/calendar.md) with our events
+- The [Matrix space](/matrix.md) for real-time communication

en/matrix.md

@@ -0,0 +1,63 @@
+# Join our Matrix Space
+
+Heart of Code has a community space on Matrix. Follow this link to join it: https://matrix.to/#/#community:matrix.heartofcode.org.
+
+If you don't know what Matrix is, follow this guide to get setup.
+
+## About Matrix
+We use [Matrix](https://matrix.org), a secure and decentralized communication platform, to collaborate and communicate. We encourage you to join our Matrix space if you want to stay informed and chat with fellow Heart of Code folks. 
+
+This guide will help you get started with our Matrix space.
+
+## Setup
+
+**Step 1: Install a Matrix Client**
+
+To use Matrix you need an app, called a *client*. There are many to choose from, but we recommend **Element**, the most widely used one. It's free and available everywhere:
+
+* **In your browser:** open https://app.element.io. Nothing to install.
+* **On your computer:** download Element Desktop from https://element.io/download.
+* **On your phone:** install **Element X** from the App Store or Google Play. If Element X can't connect to your homeserver (see Step 2), use the classic **Element** app instead.
+
+Element is just the app, it is not where your account lives. You can sign in to any Element with an account from any homeserver, and use the same account on several devices at once. If you're curious about alternatives, see https://matrix.org/ecosystem/clients/ for a comparison.
+
+**Step 2: Register an Account**
+
+After launching a Matrix client, if you don't already have a Matrix account, register a new one. You can use your email address or phone number for registration. 
+
+Heart of Code only runs a community space on Matrix, so you can't sign up with us. You will need to register with a homeserver run by someone else.
+
+If you are trying Matrix for the first time, you could choose the matrix.org homeserver. However, please take a look at the following guides to understand the tradeoffs/advice on choosing a homeserver: 
+
+* [“Join Matrix!” Guide: Basics](https://joinmatrix.org/guide/#set-up-your-own-homeserver-or-join-an-existing-homeserver). 
+* https://servers.joinmatrix.org/users.html
+
+In Element, click "Create account". The homeserver is preset to matrix.org. Click "Edit" next to it if you want to use a different one.
+
+**Step 3: Save Your Recovery Key**
+
+When you first sign in, Element will ask you to set up *recovery* (sometimes called *secure backup*). Do it, and keep the recovery key somewhere safe, like a password manager. You'll need it to read your encrypted messages on new devices. See [About Encryption](#about-encryption) below for why.
+
+**Step 4: Join Our Organization's Matrix Room**
+
+Once you've set up your account, find and join our organization's main room by searching for its ID or name in the client's search bar. Our room ID is: [`#community:matrix.heartofcode.org`](https://matrix.to/#/#community:matrix.heartofcode.org).
+
+**Step 5: Set up Notifications**
+
+Adjust your notification settings to ensure you receive important updates and messages from the team.
+
+**Step 6: Start Chatting**
+
+Feel free to introduce yourself, ask questions, and participate in discussions with your fellow Heart of Coders!
+
+Happy collaborating, and welcome to our Matrix space!
+
+## About Encryption
+
+Matrix can *end-to-end encrypt* messages, so only the people in a conversation can read them, not even the servers in between.
+
+**Encryption is set per room.** You don't need to do anything yourself: in an encrypted room, your app encrypts every message automatically. Direct messages and private rooms are usually encrypted. Public rooms often are not. Your client will usually show a badge or icon, such as a shield or lock, to tell you whether a room is encrypted.
+
+**Your recovery key keeps your history readable.** The keys to read encrypted messages are stored on your devices, not on the server. When you sign in on a new device, or sign back in after signing out, you'll need your recovery key (from Step 3) to read your older messages. If you lose it and aren't signed in anywhere else, those messages can't be recovered.
+
+If you see "Unable to decrypt", make sure recovery is set up and that you've verified your device when Element asked you to.

matrix.md

@@ -0,0 +1,61 @@
+# Tritt unserem Matrix-Space bei
+
+Heart of Code hat einen Community-Space auf Matrix. Hier ist der Link, um beizutreten: https://matrix.to/#/#community:matrix.heartofcode.org
+
+Wenn du noch nicht weißt, was Matrix ist, unten findest du eine Anleitung, wie du es einrichtest.
+
+## Über Matrix
+Wir nutzen [Matrix](https://matrix.org), eine sichere und dezentrale Kommunikationsplattform, um zusammenzuarbeiten und uns auszutauschen. Wenn du auf dem Laufenden bleiben und mit anderen Leuten aus der Heart of Code chatten möchtest, komm gerne in unseren Matrix-Space!
+
+## Einrichtung
+
+**Schritt 1: Installiere einen Matrix-Client**
+
+Um Matrix zu nutzen, brauchst du eine App, einen sogenannten *Client*. Es gibt viele davon, wir empfehlen aber **Element**, den am weitesten verbreiteten. Element ist kostenlos und für alle Geräte verfügbar:
+
+* **Im Browser:** öffne https://app.element.io. Du musst nichts installieren.
+* **Auf dem Computer:** lade Element Desktop unter https://element.io/download herunter.
+* **Auf dem Handy:** installiere **Element X** aus dem App Store oder von Google Play. Falls sich Element X nicht mit deinem Homeserver verbinden kann (siehe Schritt 2), nimm stattdessen die klassische **Element**-App.
+
+Element ist nur die App, dein Account liegt nicht dort. Du kannst dich in jedem Element mit einem Account von jedem beliebigen Homeserver anmelden und denselben Account auf mehreren Geräten gleichzeitig nutzen. Wenn du auf alternative Clients neugierig bist, schau unter https://matrix.org/ecosystem/clients/, um verschiedene Clients zu vergleichen.
+
+**Schritt 2: Registriere einen Account**
+
+Falls du noch keinen Matrix-Account hast, registriere nach dem Start des Clients einen neuen. Dafür kannst du deine E-Mail-Adresse oder Telefonnummer verwenden.
+
+Heart of Code betreibt auf Matrix nur einen Community-Space, du kannst dich also nicht bei uns registrieren. Du musst dich bei einem Homeserver registrieren, den jemand anderes betreibt.
+
+Wenn du Matrix zum ersten Mal ausprobierst, kannst du den Homeserver matrix.org wählen. Schau dir aber gerne die folgenden Anleitungen an, um die Vor- und Nachteile zu verstehen und einen passenden Homeserver auszuwählen:
+
+* [„Join Matrix!“-Anleitung: Grundlagen](https://joinmatrix.org/guide/#set-up-your-own-homeserver-or-join-an-existing-homeserver)
+* https://servers.joinmatrix.org/users.html
+
+Klicke in Element auf „Konto erstellen“. Als Homeserver ist matrix.org voreingestellt. Klicke daneben auf „Bearbeiten“, wenn du einen anderen nutzen möchtest.
+
+**Schritt 3: Speichere deinen Wiederherstellungsschlüssel**
+
+Bei der ersten Anmeldung fragt dich Element, ob du die *Wiederherstellung* ('recovery') (manchmal auch *secure backup* genannt) einrichten möchtest. Mach das und bewahre den Wiederherstellungsschlüssel an einem sicheren Ort auf, zum Beispiel in einem Passwortmanager. Du brauchst ihn, um deine verschlüsselten Nachrichten auf neuen Geräten zu lesen. Warum, erfährst du unten unter [Über Verschlüsselung](#uber-verschlusselung).
+
+**Schritt 4: Tritt unserem Matrix-Raum bei**
+
+Sobald dein Account eingerichtet ist, such in der Suchliste deines Clients nach der ID oder dem Namen unseres Hauptraums und tritt ihm bei. Unsere Raum-ID lautet: [`#community:matrix.heartofcode.org`](https://matrix.to/#/#community:matrix.heartofcode.org).
+
+**Schritt 5: Richte Benachrichtigungen ein**
+
+Passe deine Benachrichtigungseinstellungen so an, dass du wichtige Neuigkeiten und Nachrichten mitbekommst.
+
+**Schritt 6: Leg los!**
+
+Stell dich gerne vor, stell Fragen und mach bei den Diskussionen mit den anderen Heart-of-Code-Leuten mit!
+
+Viel Spaß und willkommen in unserem Matrix-Space!
+
+## Über Verschlüsselung
+
+Matrix kann Nachrichten *Ende-zu-Ende-verschlüsseln*, sodass nur die Leute im Gespräch sie lesen können, nicht einmal die Server dazwischen.
+
+**Verschlüsselung wird pro Raum eingestellt.** Du musst selbst nichts tun: In einem verschlüsselten Raum verschlüsselt deine App jede Nachricht automatisch. Direktnachrichten und private Räume sind meist verschlüsselt, öffentliche Räume oft nicht. Dein Client zeigt dir in der Regel mit einem Symbol, etwa einem Schild oder Schloss, an, ob ein Raum verschlüsselt ist.
+
+**Dein Wiederherstellungsschlüssel hält deinen Verlauf lesbar.** Die Schlüssel zum Lesen verschlüsselter Nachrichten liegen auf deinen Geräten, nicht auf dem Server. Wenn du dich auf einem neuen Gerät anmeldest oder nach einer Abmeldung wieder anmeldest, brauchst du deinen Wiederherstellungsschlüssel (aus Schritt 3), um ältere Nachrichten zu lesen. Wenn du ihn verlierst und nirgendwo sonst angemeldet bist, lassen sich diese Nachrichten nicht wiederherstellen.
+
+Wenn du „Entschlüsselung nicht möglich“ siehst, prüfe, ob die Wiederherstellung eingerichtet ist und ob du dein Gerät verifiziert hast, als Element dich darum gebeten hat.