From 996f6442fd2953ceea079c42be0ec7bb71b465d4 Mon Sep 17 00:00:00 2001 From: Julian Molina Date: Thu, 2 Sep 2021 11:27:06 +0200 Subject: [PATCH] Governance workspaces WIP --- .../distribution-event.json | 4 +- .../reusable-governance-snippets.json | 54 ++++++++++-- .../Superalgos-Pools/superalgos-pools.json | 2 +- .../Asset-Claim-Vote/asset-claim-vote.json | 12 +++ .../Asset-Weight-Vote/asset-weight-vote.json | 12 +++ .../feature-claim-vote.json | 20 +++++ .../feature-weight-vote.json | 12 +++ .../Docs-Nodes/P/Pools/Pools/pools.json | 2 +- .../position-claim-vote.json | 12 +++ .../position-weight-vote.json | 12 +++ ...-workspaces-001-governance-workspaces.json | 85 +++++++++++++++++++ ...to-governance-001-governance-overview.json | 2 +- 12 files changed, 219 insertions(+), 10 deletions(-) create mode 100644 Projects/Governance/Schemas/Docs-Topics/G/Governance/Governance-Workspaces/governance-workspaces-001-governance-workspaces.json diff --git a/Projects/Governance/Schemas/Docs-Concepts/D/Distribution/Distribution-Event/distribution-event.json b/Projects/Governance/Schemas/Docs-Concepts/D/Distribution/Distribution-Event/distribution-event.json index 332e6c42e..81d2e696e 100644 --- a/Projects/Governance/Schemas/Docs-Concepts/D/Distribution/Distribution-Event/distribution-event.json +++ b/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": [ { diff --git a/Projects/Governance/Schemas/Docs-Concepts/R/Reusable/Reusable-Governance-Snippets/reusable-governance-snippets.json b/Projects/Governance/Schemas/Docs-Concepts/R/Reusable/Reusable-Governance-Snippets/reusable-governance-snippets.json index 3ead2e35b..a9c44279d 100644 --- a/Projects/Governance/Schemas/Docs-Concepts/R/Reusable/Reusable-Governance-Snippets/reusable-governance-snippets.json +++ b/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" diff --git a/Projects/Governance/Schemas/Docs-Concepts/S/Superalgos/Superalgos-Pools/superalgos-pools.json b/Projects/Governance/Schemas/Docs-Concepts/S/Superalgos/Superalgos-Pools/superalgos-pools.json index 2326507fd..76b685f3a 100644 --- a/Projects/Governance/Schemas/Docs-Concepts/S/Superalgos/Superalgos-Pools/superalgos-pools.json +++ b/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 }, { diff --git a/Projects/Governance/Schemas/Docs-Nodes/A/Asset/Asset-Claim-Vote/asset-claim-vote.json b/Projects/Governance/Schemas/Docs-Nodes/A/Asset/Asset-Claim-Vote/asset-claim-vote.json index 11f93f55d..3928a2251 100644 --- a/Projects/Governance/Schemas/Docs-Nodes/A/Asset/Asset-Claim-Vote/asset-claim-vote.json +++ b/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" diff --git a/Projects/Governance/Schemas/Docs-Nodes/A/Asset/Asset-Weight-Vote/asset-weight-vote.json b/Projects/Governance/Schemas/Docs-Nodes/A/Asset/Asset-Weight-Vote/asset-weight-vote.json index 6c84c5b08..1953425ae 100644 --- a/Projects/Governance/Schemas/Docs-Nodes/A/Asset/Asset-Weight-Vote/asset-weight-vote.json +++ b/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" diff --git a/Projects/Governance/Schemas/Docs-Nodes/F/Feature/Feature-Claim-Vote/feature-claim-vote.json b/Projects/Governance/Schemas/Docs-Nodes/F/Feature/Feature-Claim-Vote/feature-claim-vote.json index cdedd0085..2c44ad3d1 100644 --- a/Projects/Governance/Schemas/Docs-Nodes/F/Feature/Feature-Claim-Vote/feature-claim-vote.json +++ b/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" diff --git a/Projects/Governance/Schemas/Docs-Nodes/F/Feature/Feature-Weight-Vote/feature-weight-vote.json b/Projects/Governance/Schemas/Docs-Nodes/F/Feature/Feature-Weight-Vote/feature-weight-vote.json index 7fed44919..89c0efb22 100644 --- a/Projects/Governance/Schemas/Docs-Nodes/F/Feature/Feature-Weight-Vote/feature-weight-vote.json +++ b/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" diff --git a/Projects/Governance/Schemas/Docs-Nodes/P/Pools/Pools/pools.json b/Projects/Governance/Schemas/Docs-Nodes/P/Pools/Pools/pools.json index 25a1a5b95..f89fd7364 100644 --- a/Projects/Governance/Schemas/Docs-Nodes/P/Pools/Pools/pools.json +++ b/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 }, { diff --git a/Projects/Governance/Schemas/Docs-Nodes/P/Position/Position-Claim-Vote/position-claim-vote.json b/Projects/Governance/Schemas/Docs-Nodes/P/Position/Position-Claim-Vote/position-claim-vote.json index f7734dcb5..398ea6f86 100644 --- a/Projects/Governance/Schemas/Docs-Nodes/P/Position/Position-Claim-Vote/position-claim-vote.json +++ b/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" diff --git a/Projects/Governance/Schemas/Docs-Nodes/P/Position/Position-Weight-Vote/position-weight-vote.json b/Projects/Governance/Schemas/Docs-Nodes/P/Position/Position-Weight-Vote/position-weight-vote.json index c33fd295a..0dd985ede 100644 --- a/Projects/Governance/Schemas/Docs-Nodes/P/Position/Position-Weight-Vote/position-weight-vote.json +++ b/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" diff --git a/Projects/Governance/Schemas/Docs-Topics/G/Governance/Governance-Workspaces/governance-workspaces-001-governance-workspaces.json b/Projects/Governance/Schemas/Docs-Topics/G/Governance/Governance-Workspaces/governance-workspaces-001-governance-workspaces.json new file mode 100644 index 000000000..054e2c670 --- /dev/null +++ b/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" + } + ] +} \ No newline at end of file diff --git a/Projects/Governance/Schemas/Docs-Topics/I/Introduction/Introduction-to-Governance/introduction-to-governance-001-governance-overview.json b/Projects/Governance/Schemas/Docs-Topics/I/Introduction/Introduction-to-Governance/introduction-to-governance-001-governance-overview.json index bfb92a303..dd916b1ad 100644 --- a/Projects/Governance/Schemas/Docs-Topics/I/Introduction/Introduction-to-Governance/introduction-to-governance-001-governance-overview.json +++ b/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 }, {