Updates

Author: rvl

docs/process/Chat-Rooms.md

@@ -9,83 +9,86 @@ See also: [[Communication-Conventions]]
 
 ## [[Matrix]]
 
-_Adrestia Space_ - this has its own room listing which you can explore once
+When using Element, make sure you enable the
+_Spaces_[^spaces] feature.
+
+- [_Adrestia Space_](https://element.adrestia.iohkdev.io/#/room/!AigYLvAgiNcitQyBDQ:adrestia.iohkdev.io) - this has its own room listing which you can explore once
 you've been invited.
 
-- [\#team](https://element.adrestia.iohkdev.io/#/room/#team:adrestia.iohkdev.io) - The full Adrestia team.
-- [\#matrix-testing](https://element.adrestia.iohkdev.io/#/room/#matrix-testing:adrestia.iohkdev.io) - A room for trying out features of Matrix chat rooms and client, etc.
-- [\#dev](https://element.adrestia.iohkdev.io/#/room/#dev:adrestia.iohkdev.io) - Development discussions.
+  * [\#team](https://element.adrestia.iohkdev.io/#/room/#team:adrestia.iohkdev.io) - The full Adrestia team.
+  * [\#matrix-testing](https://element.adrestia.iohkdev.io/#/room/#matrix-testing:adrestia.iohkdev.io) - A room for trying out features of Matrix chat rooms and client, etc.
+  * [\#dev](https://element.adrestia.iohkdev.io/#/room/#dev:adrestia.iohkdev.io) - Development discussions.
+
+[^spaces]: More information about _Spaces_:
+    - https://element.io/blog/spaces-the-next-frontier/
+    - https://element.io/blog/spaces-blast-out-of-beta/
+    - https://matrix.org/blog/2021/05/17/the-matrix-space-beta
 
 ## [Slack](https://input-output-rnd.slack.com])
 
-### Adrestia
+Here are a selection of possibly relevant channels on Slack.
 
-- `#adrestia-dev` - main channel for people across the company to ask questions of our team and discuss all things Adrestia.
-- `#adrestia-secret-fort` - decommissioned and replaced with Matrix.
-- `#adrestia-polyglot`
-- `#adrestia-daily`
-- `#adrestia-releases`
-- `#adrestia-leads`
-- `#cardano-launcher-dev`
-- `#daedalus-adrestia-node`
-- `#lightwallet`
-- `#recruiting_adrestia`
+:::{.highlight-block}
+#### Key
+- 🔥 High traffic
+- 👍 Recommended to join
+- ⛪ Public
+- 🔒 Private
+:::
 
-### Cardano
+### Adrestia
+- ⛪ 👍 `#adrestia-dev` - main channel for people across the company to ask questions of our team and discuss all things Adrestia.
+- 🔒 ❌ `#adrestia-secret-fort` - decommissioned and replaced with Matrix.
+- 🔒   `#adrestia-polyglot` - compilation of wallet code to javascript/webassembly.
+- 🔒    `#adrestia-daily` - status updates.
+-   👍 `#adrestia-releases` - for co-ordinating releases.
+-   👍 `#cardano-launcher-dev` - development of [cardano-launcher](https://github.com/input-output-hk/cardano-launcher).
+-   👍 `#daedalus-adrestia-node` - intersection of the three main components of Daedalus.
+-   👍 `#lightwallet` - light wallet project.
+- 🔒 ❌ `#adrestia-leads` - not used much.
+- 🔒   `#recruiting_adrestia` - used with recruitment dept to discuss of roles, filter applications on workable, arrange interviews with candidates, etc.
 
-- `cardano-dev`
-- `cardano-db-sync-dev`
-- `cardano-explorer-app-dev`
-- `#consensus`
-- `#ledger`
-- `#network`
-- `#node`
-- `#node-api-and-cli`
-- `#node-logging`
-- `#plutus`
-- `#team-cardanodocs`
+### Cardano
+-   👍 `#cardano-dev` - main channel for Cardano development.
+-   👍 `#consensus` - consensus layer development.
+-   👍 `#ledger` - ledger layer development.
+-   👍 `#network` - network layer development.
+-   👍 `#node` - [cardano-node](https://github.com/input-output-hk/cardano-node) development
+-   👍 `#node-api-and-cli` - cardano-cli and cardano-api.
+-   👍 `#node-logging` - benchmarking, logging and monitoring.
+-   👍 `#cardano-db-sync-dev` - [cardano-db-sync](https://github.com/input-output-hk/cardano-db-sync) development
+-   👍 `#cardano-explorer-app-dev` - cardano explorer frontend.
+-   👍 `#plutus` - Plutus development.
+-     `#team-cardanodocs` - documentation writing.
 
 ### Daedalus
 
-- `#daedalus` - main channel to discuss all things Daedalus.
- 
+- ⛪ 👍 `#daedalus` - main channel to discuss all things Daedalus.
+
 ### Channels for getting help
 
-- `#crossteam-ci`
-- `#ops`
-- `#haskell`
-- `#emacs-best-practices`
-- `#nix-best-practices`
+- ⛪ 👍 `#crossteam-ci` - get help with your failing builds, discuss CI issues.
+- ⛪   `#ops` - devops team public channel.
+- ⛪ 👍 `#haskell` - ask questions, discuss Haskell stuff.
+- ⛪   `#emacs-best-practices` - Emacs users.
+- ⛪ 👍 `#nix-best-practices` - get help with Nix.
 
 ### Large channels
 
-- `#engineering` - large channel for all engineering staff.
-- `#public`
-- `#public-random`
-- `#announcements`
-- `#comms`
-- `#security-public`
+- ⛪ 👍 `#engineering` - large channel for all engineering staff.
+- ⛪ 🔥 `#public` - general IOHK-relevant content.
+- ⛪ 🔥 `#public-random` - share interesting links and stories.
+- ⛪    `#announcements` - not particularly interesting, messages are usually cross-posted anyway.
+- 🔒 🔥 `#comms` - comms team discussion.
+- ⛪ 👍 `#security-public` - computer and network security.
 
 ### Special topics
 
-- `#aus`
-- `#keyboards`
-- `#fitness`
+- ⛪ `#aus` - channel for (honourary) Australians and Kiwis.
+- ⛪ `#keyboards` - input devices and related topic.
+- ⛪ `#fitness` - health and well-being.
 
 ### Admin-type things
 
-- `#concur`
-- `#udemy`
-
-
-## TODO
-
-- [ ] Add a key and tag each channel with categories
-   - 🔥 High traffic
-   - 👍 Recommended to join
-   - ⛪ Public
-   - 🔒 Private
-
-- [ ] Add more channels and descriptions.
-
-- [ ] Format in tables
+- ⛪ `#concur` - get help with SAP.
+- 🔒 `#udemy` - training platform.

docs/process/Estimation-Process.md

@@ -97,7 +97,7 @@ This practice lets us share knowledge about tasks.
 
 ## Implicit acceptance criteria
 
-Every development task is subject to the [[Definition of Done]].
+Every development task is subject to the [[Definition-of-Done]].
 
 So development tasks such as testing, documentation, review, etc, must
 be included as part of the estimate.

docs/process/Matrix.md

@@ -86,7 +86,22 @@ To enable it, choose _Set up encryption_ in your Element settings.
 
 ### "Unable to decrypt" errors
 
-1. The sender doesn’t know you exist, because when they sent the the message their server hadn’t yet seen you were in the room.
+Not quite sure why this happens. Possible causes:
+
+1. The sender doesn't know you exist, because when they sent the the message
+   their server hadn't yet seen you were in the room.
+
+2. Lack of cross-signing ("verification" of other user's sessions).
+
+### How to send direct messages which _aren't_ E2E encrypted
+
+Under Element at least, direct messages to other users default to being E2E
+encrypted, and you can't change it.
+
+In case you need it, a workaround is:
+1. Create a new private room with encryption disabled.
+2. Invite the other user to this room.
+3. Run the command `/coverttodm` in this room.
 
 ## Other clients