From 81c8402f0ae810435d638a23a048d7c73151a1d5 Mon Sep 17 00:00:00 2001 From: Aminda Suomalainen Date: Tue, 9 May 2023 11:29:19 +0300 Subject: [PATCH] pre-commit run --all-files --- README.md | 17 ++-- irc/README.md | 19 ++-- matrix/README.md | 6 +- matrix/m.room.join_rules.md | 12 +-- matrix/m.room.power_levels.md | 131 +++++++++++++-------------- matrix/tyorauha/m.room.join_rules.md | 33 ++++--- 6 files changed, 105 insertions(+), 113 deletions(-) diff --git a/README.md b/README.md index 9b0e9ee..e230581 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,5 @@ -**Table of Contents** *generated with [DocToc](https://github.com/thlorenz/doctoc)* - [Pikaviestintiimin julkisia tiedostoja](#pikaviestintiimin-julkisia-tiedostoja) @@ -8,16 +7,16 @@ # Pikaviestintiimin julkisia tiedostoja -*Briefly in English: this repository contains public files regarding - instant messenger team of Pirate Party Finland. It's mostly in Finnish - with some exceptions of `ìrc/`.* +_Briefly in English: this repository contains public files regarding +instant messenger team of Pirate Party Finland. It's mostly in Finnish +with some exceptions of `ìrc/`._ -* irc/ - enimmäkseen englanniksi IRChen liittyviä skriptejä ja dokumentaatiota. - * Enemmän aiheesta: https://git.piraattipuolue.fi/PirateIRC/ -* kanavat.csv - puolueen käytössä olevat kanavat tai ainakin ne, joissa +- irc/ - enimmäkseen englanniksi IRChen liittyviä skriptejä ja dokumentaatiota. + - Enemmän aiheesta: https://git.piraattipuolue.fi/PirateIRC/ +- kanavat.csv - puolueen käytössä olevat kanavat tai ainakin ne, joissa toistin/matterbridge on. -* matrix/ - dokumentaatiota puolueen Matrix-huoneista/Spaceista, sekä +- matrix/ - dokumentaatiota puolueen Matrix-huoneista/Spaceista, sekä esimerkki `event`tejä, joilla asettaa mm. oikeudet (`m.room.power_levels`) ja liittymisehdot (`m.room.join_rules`). -* MI1.png - toistimen käytttämä profiilikuva mm. Discordissa, kun käyttäjillä +- MI1.png - toistimen käytttämä profiilikuva mm. Discordissa, kun käyttäjillä (esim. IRCstä) ei sellaista ole. diff --git a/irc/README.md b/irc/README.md index 37e7e73..155c238 100644 --- a/irc/README.md +++ b/irc/README.md @@ -1,6 +1,5 @@ -**Table of Contents** *generated with [DocToc](https://github.com/thlorenz/doctoc)* - [Scripts for managing PPFI channels on PirateIRC](#scripts-for-managing-ppfi-channels-on-pirateirc) - [Further reading and notes](#further-reading-and-notes) @@ -17,19 +16,19 @@ The scripts only generate lines that should be copy-pasted to a IRC client for anything to actually happen. They are provided [missing GroupServ](https://github.com/ergochat/ergo/issues/465) in hope that PPFI is able to operate IRC without @Mikaela constantly present. -* `./generate-amode-cmds.bash +o MI1` - giving user `MI1` op on all channels - which will persist and be granted on join. ***Prefer this script.*** -* `./generate-oper-override-mode.bash +o MI1` - the same, except requires operator +- `./generate-amode-cmds.bash +o MI1` - giving user `MI1` op on all channels + which will persist and be granted on join. **_Prefer this script._** +- `./generate-oper-override-mode.bash +o MI1` - the same, except requires operator permission, allows unregistered accounts and doesn't persist over `/cycle` - whether manual or connection loss or similar. ***Use only in emergency + whether manual or connection loss or similar. **_Use only in emergency and even in emergency, and even then prefer amoding yourself with the previous script and then - using the next script.*** -* `./generate-usual-mode-cmds.bash +o MI1` - non-oper version of the previous script, + using the next script._** +- `./generate-usual-mode-cmds.bash +o MI1` - non-oper version of the previous script, generates normal `/mode` commands within the usual permission system most likely requiring being op (use the amode script for that, see drawbacks of the previous script). ## Further reading and notes -* (CS) AMODE +h (halfop) overrides mode `+i` (invite-only channel). -* https://github.com/ergochat/ergo/blob/master/docs/MANUAL.md#channel-prefixes - on owner/protected/op/halfop/voice -* https://github.com/ergochat/ergo/blob/master/docs/MANUAL.md#modes - on channel modes such as the aforementioned invite-only +- (CS) AMODE +h (halfop) overrides mode `+i` (invite-only channel). +- https://github.com/ergochat/ergo/blob/master/docs/MANUAL.md#channel-prefixes - on owner/protected/op/halfop/voice +- https://github.com/ergochat/ergo/blob/master/docs/MANUAL.md#modes - on channel modes such as the aforementioned invite-only diff --git a/matrix/README.md b/matrix/README.md index a467a28..58b3ac4 100644 --- a/matrix/README.md +++ b/matrix/README.md @@ -1,6 +1,5 @@ -**Table of Contents** *generated with [DocToc](https://github.com/thlorenz/doctoc)* - [Piraattipuoluen Matrix-kanaviin ja niiden hallintaan liittyvää materiaalia](#piraattipuoluen-matrix-kanaviin-ja-niiden-hallintaan-liittyv%C3%A4%C3%A4-materiaalia) @@ -10,10 +9,9 @@ Tämä nojaa vahvasti Elementin `/devtools` -komentoon, jossa enimmäkseen joko -* painetaan `explore room state` ("Huoneen tila") -* `send event` ("Lähetä mukautettu tapahtuma") +- painetaan `explore room state` ("Huoneen tila") +- `send event` ("Lähetä mukautettu tapahtuma") 1. painetaan alanurkasta `Event`, jotta se sanoo `State Event` 2. kirjoitetaan tapahtuman tyyppi, jätetään tila-avain tyhjäksi 3. kirjoitetaan (liitetään) tapahtuman sisältö 4. painetaan "Lähetä" - diff --git a/matrix/m.room.join_rules.md b/matrix/m.room.join_rules.md index 1ce9c1b..95d5ceb 100644 --- a/matrix/m.room.join_rules.md +++ b/matrix/m.room.join_rules.md @@ -1,6 +1,5 @@ -**Table of Contents** *generated with [DocToc](https://github.com/thlorenz/doctoc)* - [Tekniset liittymissäännöt työrauhaa vaativille kanaville](#tekniset-liittymiss%C3%A4%C3%A4nn%C3%B6t-ty%C3%B6rauhaa-vaativille-kanaville) - [Huoneeseen liittyminen Spaceen kuulumisen perusteella ja koputtamalla](#huoneeseen-liittyminen-spaceen-kuulumisen-perusteella-ja-koputtamalla) @@ -11,7 +10,7 @@ ## Huoneeseen liittyminen Spaceen kuulumisen perusteella ja koputtamalla -*Vaatii vähintään huoneversion ~~8~~ 9 (`restricted`) tai 10 `knock_restricted`.* +_Vaatii vähintään huoneversion ~~8~~ 9 (`restricted`) tai 10 `knock_restricted`._ TL;DR `/devtools`, explore room state, `m.room.join_rules` @@ -39,10 +38,9 @@ TL;DR `/devtools`, explore room state, `m.room.join_rules` } ``` -* `!ElEgwlkMvKtpLTcPXQ:matrix.org` on pääSpace (ei työrauha) versio 9. -* `!ESKEvwumMpSRZTnJOI:pikaviestin.fi` on pääSpace (ei työrauha) versio 10. -* `!azROMLeGEMPdbdWnbk:matrix.org` - Piraattipuolueen työrauha v9 -* `!WDaMZSVinTZRLOTajM:hacklab.fi` - Matrix Suomi (Space) v6 - +- `!ElEgwlkMvKtpLTcPXQ:matrix.org` on pääSpace (ei työrauha) versio 9. +- `!ESKEvwumMpSRZTnJOI:pikaviestin.fi` on pääSpace (ei työrauha) versio 10. +- `!azROMLeGEMPdbdWnbk:matrix.org` - Piraattipuolueen työrauha v9 +- `!WDaMZSVinTZRLOTajM:hacklab.fi` - Matrix Suomi (Space) v6 Ks. `työrauha/`, jossa on myös koputtaminen. diff --git a/matrix/m.room.power_levels.md b/matrix/m.room.power_levels.md index 683de8d..19de6cd 100644 --- a/matrix/m.room.power_levels.md +++ b/matrix/m.room.power_levels.md @@ -1,6 +1,5 @@ -**Table of Contents** *generated with [DocToc](https://github.com/thlorenz/doctoc)* - [`m.room.power_levels`](#mroompower_levels) - [Katso myös](#katso-my%C3%B6s) @@ -17,92 +16,92 @@ Perustuu https://gitea.blesmrt.net/mikaela/gist/src/branch/master/matrix/m.room. ```json { - "ban": 50, - "events": { - "im.vector.modular.widgets": 50, - "m.room.avatar": 50, - "m.room.canonical_alias": 13, - "m.room.encryption": 100, - "m.room.history_visibility": 99, - "m.room.name": 50, - "m.room.pinned_events": 25, - "m.room.power_levels": 50, - "m.room.retention": 100, - "m.room.server_acl": 99, - "m.room.tombstone": 100, - "m.room.topic": 25, - "m.space.child": 50 - }, - "events_default": 0, - "historical": 100, - "invite": 0, - "kick": 25, - "redact": 25, - "state_default": 50, - "users": { - "@matterbridgeppfi:pirateriot.net": 100, - "@matterbridgeppfi:dendrite.matrix.org": 100, - "@Ciblia:matrix.org": 100, - "@aminda:dendrite.matrix.org": 100, - "@aminda:matrix.org": 100, - "@aminda:mozilla.org": 100, - "@aminda:pikaviestin.fi": 100, - "@aminda:tedomum.net": 100, - "@mikaela:pirateriot.net": 100, - "@mikaela:tchncs.de": 100, - "@mkaysi:fedora.im": 100, - "@aminda:the-apothecary.club": 100, - "@mikaela.suomalainen:matrix.org": 100, - "@mikaela.matterbridge:converser.eu": 100, - "@mikaela.matterbridge:tedomum.net": 100, - "@aminda.matterbridge:jae.fi": 100, - "@uduntuntu:kapsi.fi": 100, - "@uduntuntu:elokapina.fi": 100, - "@mjolnir_f6d71235-63b3-43f2-9353-eb71d6e3e9e0:mjolnir.matrix.org": 99, - "@sthjs:pikaviestin.fi": 50 - }, - "users_default": 0 + "ban": 50, + "events": { + "im.vector.modular.widgets": 50, + "m.room.avatar": 50, + "m.room.canonical_alias": 13, + "m.room.encryption": 100, + "m.room.history_visibility": 99, + "m.room.name": 50, + "m.room.pinned_events": 25, + "m.room.power_levels": 50, + "m.room.retention": 100, + "m.room.server_acl": 99, + "m.room.tombstone": 100, + "m.room.topic": 25, + "m.space.child": 50 + }, + "events_default": 0, + "historical": 100, + "invite": 0, + "kick": 25, + "redact": 25, + "state_default": 50, + "users": { + "@matterbridgeppfi:pirateriot.net": 100, + "@matterbridgeppfi:dendrite.matrix.org": 100, + "@Ciblia:matrix.org": 100, + "@aminda:dendrite.matrix.org": 100, + "@aminda:matrix.org": 100, + "@aminda:mozilla.org": 100, + "@aminda:pikaviestin.fi": 100, + "@aminda:tedomum.net": 100, + "@mikaela:pirateriot.net": 100, + "@mikaela:tchncs.de": 100, + "@mkaysi:fedora.im": 100, + "@aminda:the-apothecary.club": 100, + "@mikaela.suomalainen:matrix.org": 100, + "@mikaela.matterbridge:converser.eu": 100, + "@mikaela.matterbridge:tedomum.net": 100, + "@aminda.matterbridge:jae.fi": 100, + "@uduntuntu:kapsi.fi": 100, + "@uduntuntu:elokapina.fi": 100, + "@mjolnir_f6d71235-63b3-43f2-9353-eb71d6e3e9e0:mjolnir.matrix.org": 99, + "@sthjs:pikaviestin.fi": 50 + }, + "users_default": 0 } ``` Mitä tämä sallii vrt. oletus? -* Historian näkyvyyttä voi vaihtaa olematta ylläpitäjä (PL99 vs PL100) -* PL99 voi antaa porttikieltoja kokonaisille palvelimille (Mjolnir), jotta +- Historian näkyvyyttä voi vaihtaa olematta ylläpitäjä (PL99 vs PL100) +- PL99 voi antaa porttikieltoja kokonaisille palvelimille (Mjolnir), jotta se voidaan tarpeen vaatiessa alentaa. -* Moderaattorit voivat ylentää muita moderaattoriksi (PL50), mutta eivät voi alentaa. - * Erityisen luotetuille voinee antaa 51 tai enemmän? -* Kaikki voivat kutsua muita käyttäjiä huoneeseen (toistaiseksi sitä ei ole väärinkäytetty +- Moderaattorit voivat ylentää muita moderaattoriksi (PL50), mutta eivät voi alentaa. + - Erityisen luotetuille voinee antaa 51 tai enemmän? +- Kaikki voivat kutsua muita käyttäjiä huoneeseen (toistaiseksi sitä ei ole väärinkäytetty puolueen piirissä, vähemmän työtä ylläpidolle lisätessä huoneisiin ja väärinkäyttäjän pitäisi jokatapauksessa päästä koputuksen tai sallitun Spacen läpi) -* IRCstä tuttu half-op on PL25 ja voi vaihtaa topicia, kiinnitettyjä viestejä +- IRCstä tuttu half-op on PL25 ja voi vaihtaa topicia, kiinnitettyjä viestejä tai poistaa viestejä/käyttäjiä huoneesta (ei bannata). - * Esimerkkikäyttötapaus: henkilö ei halua moderoida banneja, mutta hänen + - Esimerkkikäyttötapaus: henkilö ei halua moderoida banneja, mutta hänen tarvitsee muokata topicista päivämääriä tai poiistaa toistettua spammia. -* PL13 voi asettaa pääaliaksen, lisätä/poistaa julkaistuja aliaksia ja +- PL13 voi asettaa pääaliaksen, lisätä/poistaa julkaistuja aliaksia ja (tapauksessa Synapse) [julkistaa/poistaa huonehakemistosta](https://github.com/vector-im/element-web/issues/13835). - * Pääalias ei vaikuta `ctrl-k` käyttöön niin paljon. - * Huoneet löydetään yleensä Spacejen tai Matrix-linkkien kautta + - Pääalias ei vaikuta `ctrl-k` käyttöön niin paljon. + - Huoneet löydetään yleensä Spacejen tai Matrix-linkkien kautta (joissa määritetään huoneen sisäinen ID aliaksen sijaan). - * Palvelimen huonehakemistot ovat etenkin suuremmilla palvelimilla laadultaan + - Palvelimen huonehakemistot ovat etenkin suuremmilla palvelimilla laadultaan vaihtelevia, niissä oleminen tai puuttuminen ei ole menetys. Ks. Spacet. - * Tätäkään oikeutta ei tule antaa täysin epäluotetuille käyttäjille. + - Tätäkään oikeutta ei tule antaa täysin epäluotetuille käyttäjille. Voimalliset käyttäjät -* `@matterbridgeppfi:pirateriot.net` - toistinbotti (Verkkopalvelutiimillä pääsy) -* `Ciblia`, `mikaela`, `mkaysi` ja `aminda` ovat Aminda Suomalainen, jonka +- `@matterbridgeppfi:pirateriot.net` - toistinbotti (Verkkopalvelutiimillä pääsy) +- `Ciblia`, `mikaela`, `mkaysi` ja `aminda` ovat Aminda Suomalainen, jonka toistinbotilla on myös varmuuden vuoksi oikeuksia. -* `uduntuntu` on tietysti Utu Hopiavuori -* `@mjolnir_f6d71235-63b3-43f2-9353-eb71d6e3e9e0:mjolnir.matrix.org"` - `@matterbridgeppfi:dendrite.matrix.org` +- `uduntuntu` on tietysti Utu Hopiavuori +- `@mjolnir_f6d71235-63b3-43f2-9353-eb71d6e3e9e0:mjolnir.matrix.org"` - `@matterbridgeppfi:dendrite.matrix.org` provisioima mjolnir-for-all -instanssi, spämmintorjunta. Tasolla 99, jotta siitä päästään tarpeen vaatiessa eroon. -*PL100 ei voi alentaa muita PL100-käyttäjiä ja PL100 on oletus huonetta luodessa. +_PL100 ei voi alentaa muita PL100-käyttäjiä ja PL100 on oletus huonetta luodessa. Tämän vuoksi huoneissa saattaa olla myös vanhoja voimallisia käyttäjiä, esimerkiksi -verkosta poistuneilta palvelimilta `disroot.org`, `privacytools.io` ja `feneas.org`.* +verkosta poistuneilta palvelimilta `disroot.org`, `privacytools.io` ja `feneas.org`._ ## Katso myös -* [Amindan blogi: Matrix abuse protection model for community maintainers: security by obscurity](https://www.aminda.eu/blog/english/2021/12/05/matrix-community-abuse-security-by-obscurity.html) - * käyttää esimerkkinä juuri miten puolueen huoneet on organisoitu. +- [Amindan blogi: Matrix abuse protection model for community maintainers: security by obscurity](https://www.aminda.eu/blog/english/2021/12/05/matrix-community-abuse-security-by-obscurity.html) + - käyttää esimerkkinä juuri miten puolueen huoneet on organisoitu. diff --git a/matrix/tyorauha/m.room.join_rules.md b/matrix/tyorauha/m.room.join_rules.md index 5638c12..f3a797f 100644 --- a/matrix/tyorauha/m.room.join_rules.md +++ b/matrix/tyorauha/m.room.join_rules.md @@ -1,6 +1,5 @@ -**Table of Contents** *generated with [DocToc](https://github.com/thlorenz/doctoc)* - [Tekniset liittymissäännöt työrauhaa vaativille kanaville](#tekniset-liittymiss%C3%A4%C3%A4nn%C3%B6t-ty%C3%B6rauhaa-vaativille-kanaville) - [Huoneeseen liittyminen Spaceen kuulumisen perusteella ja koputtamalla](#huoneeseen-liittyminen-spaceen-kuulumisen-perusteella-ja-koputtamalla) @@ -12,34 +11,34 @@ ## Huoneeseen liittyminen Spaceen kuulumisen perusteella ja koputtamalla -*Vaatii vähintään huoneversion ~~8~~ 9 (`restricted`) tai 10 `knock_restricted`.* +_Vaatii vähintään huoneversion ~~8~~ 9 (`restricted`) tai 10 `knock_restricted`._ TL;DR `/devtools`, explore room state, `m.room.join_rules` ```json { - "allow": [ - { - "room_id": "!oHIvaRnuEEIDavQVRJ:matrix.org", - "type": "m.room_membership" - }, - { - "room_id": "!azROMLeGEMPdbdWnbk:matrix.org", - "type": "m.room_membership" - } - ], - "join_rule": "knock_restricted" + "allow": [ + { + "room_id": "!oHIvaRnuEEIDavQVRJ:matrix.org", + "type": "m.room_membership" + }, + { + "room_id": "!azROMLeGEMPdbdWnbk:matrix.org", + "type": "m.room_membership" + } + ], + "join_rule": "knock_restricted" } ``` -* `!oHIvaRnuEEIDavQVRJ:matrix.org` - Työrauha-space versio 6 (taaksepäin yhteensopivuuden vuoksi) -* `!azROMLeGEMPdbdWnbk:matrix.org` - Työrauha-space versio 9 (tätä pitäisi oikeasti käyttää) +- `!oHIvaRnuEEIDavQVRJ:matrix.org` - Työrauha-space versio 6 (taaksepäin yhteensopivuuden vuoksi) +- `!azROMLeGEMPdbdWnbk:matrix.org` - Työrauha-space versio 9 (tätä pitäisi oikeasti käyttää) ## Koputtamisen salliminen -*Vaatii vähintään huoneversio 7.* +_Vaatii vähintään huoneversio 7._ -*Kirjoitusaikana Elementit [Android](https://github.com/vector-im/element-android/issues/3875), [iOS](https://github.com/vector-im/element-ios/issues/4731) ja [Web/Desktop](https://github.com/vector-im/element-web/issues/18655) eivät tue tätä.* +_Kirjoitusaikana Elementit [Android](https://github.com/vector-im/element-android/issues/3875), [iOS](https://github.com/vector-im/element-ios/issues/4731) ja [Web/Desktop](https://github.com/vector-im/element-web/issues/18655) eivät tue tätä._ TL;DR `/devtools`, explore room state, `m.room.join_rules`: