arbitration: more text

specification/docs/arbitration.md

@@ -1,3 +1,5 @@
+Here we outline a sequence representing the on-chain portion of the dispute initiation and resolution process. If a Disputed Contract includes a "Trigger clause", a Complainant may initiate a dispute. The disputed funds are sent to the Arbitration DAO, and are held in escrow until a decision is rendered.
+
 ```mermaid
 sequenceDiagram
 
@@ -62,6 +64,10 @@ end %% opt
 
 deactivate arbitration
 deactivate forum
+```
 
+The above sequence assumes that each instance of an Arbitration contract corresponds to a particular area of expertise. A contract which wants to support dispute initiation must select an Arbitration contract in advance, and the dispute will be assigned to an Arbitrator who has staked availability on that Arbitration contract.
 
-```
+A single Arbitration DAO may support multiple areas of expertise by deploying an Arbitration contract instance for each area of expertise. However, all of these instances would be governed by a single type of Reputation.
+
+Alternatively, a new Arbitration DAO may be deployed for a given area of expertise. This Arb DAO would have its own type of Reputation, independent of other Arb DAOs.

specification/docs/user-stories.md

@@ -1,5 +1,62 @@
 ## Experts start a new DAO
 
+### Deploy DAO Contracts
+
+```mermaid
+sequenceDiagram
+
+participant Admin
+box DAO Core
+participant Reputation
+participant Forum
+participant Bench
+participant DAO
+end 
+box Additional DAO Contracts
+participant Rollup
+participant Proposals
+participant Work
+participant Onboarding
+end
+
+Admin ->> Reputation : Deploy
+Admin ->> Forum : Deploy
+Admin ->> Bench : Deploy
+Admin ->> DAO : Deploy
+DAO -->> Reputation : Registers DAO Contract
+DAO -->> Forum : Registers DAO Contract
+DAO -->> Bench : Registers DAO Contract
+Admin ->> Rollup : Deploy
+Rollup -->> DAO : References DAO Contract
+Admin ->> Proposals : Deploy
+Proposals -->> DAO : References DAO Contract
+Admin ->> Work : Deploy
+Work -->> DAO : References DAO Contract
+Admin ->> Onboarding : Deploy
+Onboarding -->> DAO : References DAO Contract
+
+```
+
+### Deploy Forum API
+
+```mermaid
+sequenceDiagram
+
+```
+
+### Deploy Matrix Widget
+
+```mermaid
+sequenceDiagram
+
+participant e1 as Expert 1
+participant e2 as Expert 2
+participant matrix as Matrix
+participant api as Forum API
+participant widget as Matrix Widget
+
+```
+
 ## New member joins a DAO
 
 ## DAO member defines a new Work Contract