pre-commit run --all-files

This commit is contained in:
Aminda Suomalainen ⚧ 2023-05-09 11:29:19 +03:00
parent 62adf93387
commit 81c8402f0a
SSH Key Fingerprint: SHA256:CXLULpqNBdUKB6E6fLA1b/4SzG0HvKD19PbIePU175Q
6 changed files with 105 additions and 113 deletions

View File

@ -1,6 +1,5 @@
<!-- START doctoc generated TOC please keep comment here to allow auto update -->
<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
**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.

View File

@ -1,6 +1,5 @@
<!-- START doctoc generated TOC please keep comment here to allow auto update -->
<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
**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

View File

@ -1,6 +1,5 @@
<!-- START doctoc generated TOC please keep comment here to allow auto update -->
<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
**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ä"

View File

@ -1,6 +1,5 @@
<!-- START doctoc generated TOC please keep comment here to allow auto update -->
<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
**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.

View File

@ -1,6 +1,5 @@
<!-- START doctoc generated TOC please keep comment here to allow auto update -->
<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
**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.

View File

@ -1,6 +1,5 @@
<!-- START doctoc generated TOC please keep comment here to allow auto update -->
<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
**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`: