Update 'Tech to do list'

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
+Login if exsiting user on the instance  
-Create new account as:
+- 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
+* Determines who gets placed in a given 'Body'
-
+* Runs every 10 mins
-* runs every 10 mins
+* Looks for any space in body
-
+* Uses the ratios of sortition into 'Body Member' (1/3 1/3 1/3)
-* looks for any space in body
+  * candidate for each pool are selected randomly from the candidates (who are taking part)
-
+* Updates the new members rolls
-* 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 
-
 * Posts to [ActivityPub](https://activitypub.rocks/) and alerts via email
-
+  * **_[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
+* 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
+- 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`:
+-