Governance workspaces WIP

Projects/Governance/Schemas/Docs-Concepts/D/Distribution/Distribution-Event/distribution-event.json

@@ -1,8 +1,8 @@
 {
     "type": "Distribution Event",
     "definition": {
-        "text": "The Superalgos Project distributes its native Superalgos SA Tokens after each release to compensate contributions and incentivize desirable behaviors. The Distribution Event represents the moment in time and the act of running the process that distributes tokens from the Treasury Account to the Governance Address associated with each User Profile that participates in governance.",
-        "updated": 1630234849482
+        "text": "The Superalgos Project distributes its native Superalgos SA Tokens after each release to reward contributions and incentivize desirable behaviors. The Distribution Event represents the moment in time and the act of running the process that distributes tokens from the Treasury Account to the Governance Address associated with each User Profile that participates in governance.",
+        "updated": 1630570602251
     },
     "paragraphs": [
         {

Projects/Governance/Schemas/Docs-Concepts/R/Reusable/Reusable-Governance-Snippets/reusable-governance-snippets.json

@@ -9,27 +9,71 @@
             "style": "Title",
             "text": "Computational Limitations"
         },
-        {
-            "style": "Block",
-            "text": "Computational Limitations"
-        },
         {
             "style": "Title",
             "text": ""
         },
         {
-            "style": "Note",
+            "style": "Block",
+            "text": "Computational Limitations",
+            "updated": 1630569942063
+        },
+        {
+            "style": "Text",
             "text": "The governance system does all calculations dynamically, in real-time, with every change in the definitions, and computes all the hierarchies loaded in the Current Workspace."
         },
         {
             "style": "Important",
             "text": "The above means that the calculations that you see from within any given Workspace is a partial calculation within the scope of the Current Workspace only. Definitions, claims, votes, and so on, existing on other workspaces or plugins are not computed."
         },
+        {
+            "style": "Block",
+            "text": "Computational Limitations 2",
+            "updated": 1630569818098
+        },
+        {
+            "style": "Text",
+            "text": "If you cast votes or place claims in more than one Governance Workspace, you will not be able to see what some of your claims and votes are about — in particular, those that live on a workspace that is not the Current Workspace.",
+            "updated": 1630569998640
+        },
+        {
+            "style": "Text",
+            "text": "If you wish to have a clearer picture of all your votes and claims, you may want to set up a new workspace that includes all the hierarchies that you need to interact with. That way, you will be able to see all of your votes and claims at the same time. To do this, save a new workspace deriving from one of the Governance Workspaces and load the plugins you need.",
+            "updated": 1630570350637
+        },
+        {
+            "style": "Note",
+            "text": "Even if you do as suggested above, the calculations you see in terms of Token Rewards, Tokens Awarded, Tokens Bonus, and so on, are still partial. The actual Distribution Event calculation involves computing all of the Project Definition Hierarchies, including all User Profile hierarchies participating in governance.",
+            "updated": 1630570663757
+        },
+        {
+            "style": "Text",
+            "text": ""
+        },
         {
             "style": "Block",
             "text": "Dummy",
             "updated": 1630230740442
         },
+        {
+            "style": "Title",
+            "text": "Deep in Governance",
+            "updated": 1630574167914
+        },
+        {
+            "style": "Block",
+            "text": "Deep in Governance"
+        },
+        {
+            "style": "Success",
+            "text": "If you have contributed work or wish to go deep with your participation in governance, you will most likely need to interact with one or more of the project-specific Governance Workspaces. To do that, load your User Profile into the corresponding workspaces so that you may establish references to place Contribution Claims and cast Weight Votes.",
+            "updated": 1630574190576
+        },
+        {
+            "style": "Block",
+            "text": "Dummy",
+            "updated": 1630574197424
+        },
         {
             "style": "Title",
             "text": "Featuring Tokens Bonus"

Projects/Governance/Schemas/Docs-Concepts/S/Superalgos/Superalgos-Pools/superalgos-pools.json

@@ -12,7 +12,7 @@
         },
         {
             "style": "Text",
-            "text": "Because this is the highest level definition of how tokens will be distributed, the Superalgos Pools hierarchy is present in all Governance Plugin Workspaces.",
+            "text": "Because this is the highest level definition of how tokens will be distributed, the Superalgos Pools hierarchy is present in all Governance Workspaces.",
             "updated": 1630426648511
         },
         {

Projects/Governance/Schemas/Docs-Nodes/A/Asset/Asset-Claim-Vote/asset-claim-vote.json

@@ -14,6 +14,18 @@
             "style": "Include",
             "text": "Governance->Concept->Reusable Governance Snippets->Claim Votes Content"
         },
+        {
+            "style": "Subtitle",
+            "text": "Working on Multiple Workspaces"
+        },
+        {
+            "style": "Include",
+            "text": "Governance->Concept->Reusable Governance Snippets->Deep in Governance"
+        },
+        {
+            "style": "Include",
+            "text": "Governance->Concept->Reusable Governance Snippets->Computational Limitations 2"
+        },
         {
             "style": "Block",
             "text": "Configuration"

Projects/Governance/Schemas/Docs-Nodes/A/Asset/Asset-Weight-Vote/asset-weight-vote.json

@@ -14,6 +14,18 @@
             "style": "Include",
             "text": "Governance->Concept->Weight Votes->Content"
         },
+        {
+            "style": "Subtitle",
+            "text": "Working on Multiple Workspaces"
+        },
+        {
+            "style": "Include",
+            "text": "Governance->Concept->Reusable Governance Snippets->Deep in Governance"
+        },
+        {
+            "style": "Include",
+            "text": "Governance->Concept->Reusable Governance Snippets->Computational Limitations 2"
+        },
         {
             "style": "Block",
             "text": "Configuration"

Projects/Governance/Schemas/Docs-Nodes/F/Feature/Feature-Claim-Vote/feature-claim-vote.json

@@ -14,6 +14,26 @@
             "style": "Include",
             "text": "Governance->Concept->Reusable Governance Snippets->Claim Votes Content"
         },
+        {
+            "style": "Subtitle",
+            "text": "Working on Multiple Workspaces"
+        },
+        {
+            "style": "Include",
+            "text": "Governance->Concept->Reusable Governance Snippets->Deep in Governance"
+        },
+        {
+            "style": "Include",
+            "text": "Governance->Concept->Reusable Governance Snippets->Computational Limitations 2"
+        },
+        {
+            "style": "Subtitle",
+            "text": ""
+        },
+        {
+            "style": "Text",
+            "text": ""
+        },
         {
             "style": "Block",
             "text": "Configuration"

Projects/Governance/Schemas/Docs-Nodes/F/Feature/Feature-Weight-Vote/feature-weight-vote.json

@@ -14,6 +14,18 @@
             "style": "Include",
             "text": "Governance->Concept->Weight Votes->Content"
         },
+        {
+            "style": "Subtitle",
+            "text": "Working on Multiple Workspaces"
+        },
+        {
+            "style": "Include",
+            "text": "Governance->Concept->Reusable Governance Snippets->Deep in Governance"
+        },
+        {
+            "style": "Include",
+            "text": "Governance->Concept->Reusable Governance Snippets->Computational Limitations 2"
+        },
         {
             "style": "Block",
             "text": "Configuration"

Projects/Governance/Schemas/Docs-Nodes/P/Pools/Pools/pools.json

@@ -29,7 +29,7 @@
         },
         {
             "style": "Text",
-            "text": "In addition, there is a third resource characteristic to the Pool Hierarchy. Each Pool may reference a separate Pools hierarchy so that the definitions may continue on a separate hierarchy, which may be included as a plugin in the same or in separate Governance Plugin Workspaces.",
+            "text": "In addition, there is a third resource characteristic to the Pool Hierarchy. Each Pool may reference a separate Pools hierarchy so that the definitions may continue on a separate hierarchy, which may be included as a plugin in the same or in separate Governance Workspaces.",
             "updated": 1630426515819
         },
         {

Projects/Governance/Schemas/Docs-Nodes/P/Position/Position-Claim-Vote/position-claim-vote.json

@@ -15,6 +15,18 @@
             "text": "Governance->Concept->Reusable Governance Snippets->Claim Votes Content",
             "updated": 1630350813522
         },
+        {
+            "style": "Subtitle",
+            "text": "Working on Multiple Workspaces"
+        },
+        {
+            "style": "Include",
+            "text": "Governance->Concept->Reusable Governance Snippets->Deep in Governance"
+        },
+        {
+            "style": "Include",
+            "text": "Governance->Concept->Reusable Governance Snippets->Computational Limitations 2"
+        },
         {
             "style": "Block",
             "text": "Configuration"

Projects/Governance/Schemas/Docs-Nodes/P/Position/Position-Weight-Vote/position-weight-vote.json

@@ -14,6 +14,18 @@
             "style": "Include",
             "text": "Governance->Concept->Weight Votes->Content"
         },
+        {
+            "style": "Subtitle",
+            "text": "Working on Multiple Workspaces"
+        },
+        {
+            "style": "Include",
+            "text": "Governance->Concept->Reusable Governance Snippets->Deep in Governance"
+        },
+        {
+            "style": "Include",
+            "text": "Governance->Concept->Reusable Governance Snippets->Computational Limitations 2"
+        },
         {
             "style": "Block",
             "text": "Configuration"

Projects/Governance/Schemas/Docs-Topics/G/Governance/Governance-Workspaces/governance-workspaces-001-governance-workspaces.json

@@ -0,0 +1,85 @@
+{
+    "topic": "Governance Workspaces",
+    "pageNumber": "1",
+    "type": "Governance Workspaces",
+    "definition": {
+        "text": "The Governance Project features multiple Project Definition Hierarchies spread across multiple Plugin Workspaces — one Workspace per Project — to facilitate the granular management of definitions by independent teams of maintainers. These are the Governance Workspaces.",
+        "updated": 1630567756861
+    },
+    "paragraphs": [
+        {
+            "style": "Title",
+            "text": "Main Governance Workspace",
+            "updated": 1630568120363
+        },
+        {
+            "style": "Text",
+            "text": "The Token Distribution Superalgos Governance Workspace is the main workspace. Load this workspace to start your interaction with governance. This is where you would usually build and set up your User Profile.",
+            "updated": 1630568963531
+        },
+        {
+            "style": "Title",
+            "text": "Naming Convention"
+        },
+        {
+            "style": "Text",
+            "text": "All Governance Workspaces follow a similar naming structure, to make them easy to spot in the Workspaces Tab:"
+        },
+        {
+            "style": "Json",
+            "text": "Token Distribution XXX Project",
+            "updated": 1630568716919
+        },
+        {
+            "style": "Note",
+            "text": "XXX is replaced with the actual name of the Project.",
+            "updated": 1630568059149
+        },
+        {
+            "style": "Title",
+            "text": "Finding Your Way Arround Governance Workspaces",
+            "updated": 1630568467050
+        },
+        {
+            "style": "Text",
+            "text": "Each of the Governance Workspaces features several Project Definition Hierarchies describing the Pools, Assets, Features, and Positions of the corresponding Project.",
+            "updated": 1630568821141
+        },
+        {
+            "style": "Include",
+            "text": "Governance->Concept->Reusable Governance Snippets->Deep in Governance"
+        },
+        {
+            "style": "Text",
+            "text": ""
+        },
+        {
+            "style": "Title",
+            "text": "Superalgos Pools Hierarchy",
+            "updated": 1630568627153
+        },
+        {
+            "style": "Include",
+            "text": "Governance->Concept->Superalgos Pools->Definition",
+            "updated": 1630568552530
+        },
+        {
+            "style": "Include",
+            "text": "Governance->Concept->Superalgos Pools->Content"
+        },
+        {
+            "style": "Title",
+            "text": "Scope of Calculations",
+            "updated": 1630569279039
+        },
+        {
+            "style": "Include",
+            "text": "Governance->Concept->Reusable Governance Snippets->Computational Limitations",
+            "updated": 1630569313627
+        },
+        {
+            "style": "Include",
+            "text": "Governance->Concept->Reusable Governance Snippets->Computational Limitations 2"
+        }
+    ]
+}

Projects/Governance/Schemas/Docs-Topics/I/Introduction/Introduction-to-Governance/introduction-to-governance-001-governance-overview.json

@@ -55,7 +55,7 @@
         },
         {
             "style": "Text",
-            "text": "Governance is defined across multiple Governance Plugin Workspaces that users may load and contribute to. These workspaces feature the definitions of several hierarchies that determine the relationship of all the concepts affecting governance.",
+            "text": "Governance is defined across multiple Governance Workspaces that users may load and contribute to. These workspaces feature the definitions of several hierarchies that determine the relationship of all the concepts affecting governance.",
             "updated": 1630424913354
         },
         {