From d94c7041750c2d0f1e360b206e2c8a063944cd13 Mon Sep 17 00:00:00 2001
From: mj-saunders <mj-saunders@noreply.%(DOMAIN)s>
Date: Thu, 17 Feb 2022 13:09:14 +0000
Subject: [PATCH] Update 'Tech to do list'

---
 Tech-to-do-list.md | 70 +++++++++++++++++++++++++++++-----------------
 1 file changed, 44 insertions(+), 26 deletions(-)

diff --git a/Tech-to-do-list.md b/Tech-to-do-list.md
index b490e8a..9870b9a 100644
--- a/Tech-to-do-list.md
+++ b/Tech-to-do-list.md
@@ -13,36 +13,31 @@ Including a group that checks if some is a stakeholder or affiliate.
 
 
 ### Signup Module
-Login if exsiting user on the instance
-Create new account as:
+Login if exsiting user on the instance  
+- Create new account as 'Member' (everyone):
+  - may decide to only observe or take part
+  - create a personal wiki page with their activiy pub stream; to do with what they want
+- Upgrade to 'Stakeholder Member':
+  - fill in questionnaire body (template)
+  - a tagged activity pub message will get posted to the approval group
+  - group members must each submit 'approve' or 'disapprove'
+- Upgrade to 'Affiliate Member':
+  - Fill in questionnaire body (template)
+  - a tagged activity pub message will get posted to the approval group
+  - group members must each submit 'approve' or 'disapprove'
 
-member (everyone) decide to only observe or take part. create a perssonal wiki page with their activiy pub stream. Do with what they want
-
-Upgrade to stake holder Member
-    Fill in questionay body (template)
-        a tagged activity pub will go to the approval group
-            anyone there clicks ok or not
-
-Upgrade to Afiliate Member
-    Fill in questionay body (template)
-        a tagged activity pub will go to the approval group
-            anyone there clicks ok or not
             
 ### [Sortition](https://en.wikipedia.org/wiki/Sortition) Module
 
-* to be in a body
-
-* runs every 10 mins
-
-* looks for any space in body
-
-* used the ratios of sortation into Body Member (1/3 1/3 1/3) to pick a candidate for each pool the randomly sleects from the cadidates (who are taking part)
-
-* Updates the new members rolls 
-
+* Determines who gets placed in a given 'Body'
+* Runs every 10 mins
+* Looks for any space in body
+* Uses the ratios of sortition into 'Body Member' (1/3 1/3 1/3)
+  * candidate for each pool are selected randomly from the candidates (who are taking part)
+* Updates the new members rolls
 * Posts to [ActivityPub](https://activitypub.rocks/) and alerts via email
-
-* second sortition runs to pick voices of the body
+  * **_[Q. How many ActPub "users"/streams will there be? One for Organisation, one per Body, one per Member?]_**
+* Second sortition runs to pick 'Voices' of the 'Body'
   * 3 to 5 are picked as sortated as voices (see above)
 
 * [add activiy time outs and time limits]
@@ -253,4 +248,27 @@ The content of the groups is stored in a wiki (we use an off the shelf one).
 
 Each group has:
 - Wiki
-- Member list
\ No newline at end of file
+- Member list
+
+
+---
+
+## Definitions
+Some or all of these may already exist on other pages - can link or move elsewhere if preferable
+
+### Human
+- `Body`:
+- `Member`:
+- `Stakeholder`:
+- `Affiliate`:
+- `Voice`:
+- `Group`:
+- `Role`:
+- `Admin`:
+- `Sortition`:
+
+### Technical
+- `Extension/Module`: Interchangeable terms referring to XWiki Extensions
+- `ActivityPub`:
+- `Flag`:
+- 
\ No newline at end of file