Merge pull request #1611 from julian-molina/develop

Contribution: Voting Program WIP
2021-08-30 23:01:50 +02:00
commit 0f3a6a9786
@@ -0,0 +1,13 @@
+{
+    "type": "Claim Support Power",
+    "definition": {
+        "text": "Claim Support Power is the Voting Power that goes into a Claim Votes Switch or Claim Votes in general and is a measure of how much you wish to support the Contribution Claims you are voting for.",
+        "updated": 1630355883567
+    },
+    "paragraphs": [
+        {
+            "style": "Text",
+            "text": "Right click and Edit to enter edit mode and change this text. ENTER to write new paragraphs. ESC to exit edit mode. Then you can use docs.save to save your changes and app.contribute to send it to the main repository."
+        }
+    ]
+}
@@ -1,8 +1,8 @@
 {
    "type": "Claim Votes",
    "definition": {
-        "text": "Claim Votes is a generalization referring to either or all of the existing variations (Position Contribution Claim Vote, Feature Contribution Claim Vote, and Asset Contribution Claim Vote nodes) without making such a distinction for being irrelevant in the particular context.",
-        "updated": 1624781423463
+        "text": "In general terms, Claim Votes allow you to support the claims of other users. The term Claim Votes is a generalization referring to either or all of the existing types: Position Claim Vote, Feature Claim Vote, and Asset Claim Vote nodes.",
+        "updated": 1630343978470
    },
    "paragraphs": [
        {
@@ -12,7 +12,8 @@
        },
        {
            "style": "Callout",
-            "text": "Claim Votes is a generalization referring to either or all of the existing variations (Position Contribution Claim Vote, Feature Contribution Claim Vote, and Asset Contribution Claim Vote nodes) without making such a distinction for being irrelevant in the particular context."
+            "text": "In general terms, Claim Votes allow you to support the claims of other users. The term Claim Votes is a generalization referring to either or all of the existing particular types: Position Claim Vote, Feature Claim Vote, and Asset Claim Vote nodes.",
+            "updated": 1630343984130
        }
    ]
 }
@@ -61,8 +61,12 @@
        },
        {
            "style": "Callout",
-            "text": "Use a Claims Folder node to establish a reference with the corresponding type of Class node. Then use the Install Missing Claims option on the menu of the Claims Folder to map the entire Class! The process creates a Claims Folder for each Class, and a claim for each Asset, Feature, or Position defined within each Class. If something changes on the side of the definitions, you may always go back a run the Install Missing Claims process again. The process will remap the structure with the appropriate claims and folders.",
-            "updated": 1630324164950
+            "text": "Use a Claims Folder node to establish a reference with the corresponding type of Class node. Then use the Install Missing Claims option on the menu of the Claims Folder to map the entire Class! The process creates a Claims Folder for each Class, and a claim for each Asset, Feature, or Position defined within each Class. ",
+            "updated": 1630357212192
+        },
+        {
+            "style": "Success",
+            "text": "If something changes on the side of the definitions, you may always go back a run the Install Missing Claims process again. The process will remap the structure with the appropriate claims and folders."
        }
    ]
 }
@@ -0,0 +1,13 @@
+{
+    "type": "Contribution Claims",
+    "definition": {
+        "text": "The term Contribution Claims is a generalization of the concept of claims and may refer to any or all of the existing types, namely Asset Contribution Claim, Feature Contribution Claim, and Position Contribution Claim nodes.",
+        "updated": 1630351499915
+    },
+    "paragraphs": [
+        {
+            "style": "Text",
+            "text": "Right click and Edit to enter edit mode and change this text. ENTER to write new paragraphs. ESC to exit edit mode. Then you can use docs.save to save your changes and app.contribute to send it to the main repository."
+        }
+    ]
+}
@@ -77,13 +77,46 @@
            "text": "Claims Content"
        },
        {
-            "style": "Success",
+            "style": "Important",
            "text": "Make sure you're driving enough Claim Power to the node so that you may get the reward you deserve! And remember to ask the people who know your work to vouch for your claims with their Claim Votes. That is how your contribution gets validated and how you get the associated rewards.",
            "updated": 1630325171869
        },
        {
            "style": "Note",
            "text": "Learn more about How Claims are Resolved!"
+        },
+        {
+            "style": "Block",
+            "text": "Dummy",
+            "updated": 1630350577178
+        },
+        {
+            "style": "Title",
+            "text": "Claim Votes Content",
+            "updated": 1630350592141
+        },
+        {
+            "style": "Block",
+            "text": "Claim Votes Content",
+            "updated": 1630350596729
+        },
+        {
+            "style": "Important",
+            "text": "The Claim Support Power you drive into Claim Votes nodes is significant, as it is a measure of your support to the claim. The ideal case scenario for the party placing the claim is that the claim gets enough Claim Votes with enough Claim Support Power to match the Claim Power the claim carries.",
+            "updated": 1630356135160
+        },
+        {
+            "style": "Success",
+            "text": "You may want to learn more about How Claims are Resolved!"
+        },
+        {
+            "style": "Block",
+            "text": "Dummy"
+        },
+        {
+            "style": "Text",
+            "text": "Title",
+            "updated": 1630350617116
        }
    ]
 }
@@ -0,0 +1,13 @@
+{
+    "type": "Weight Power",
+    "definition": {
+        "text": "Weight Power is the Voting Power that goes into a Weight Votes Switch or Weight Votes in general and is a measure of how much you wish to incentivize the node you are voting for.",
+        "updated": 1630355707896
+    },
+    "paragraphs": [
+        {
+            "style": "Text",
+            "text": "Right click and Edit to enter edit mode and change this text. ENTER to write new paragraphs. ESC to exit edit mode. Then you can use docs.save to save your changes and app.contribute to send it to the main repository."
+        }
+    ]
+}
@@ -1,13 +1,23 @@
 {
    "type": "Weight Votes",
    "definition": {
-        "text": "A type of vote within the Voting Program used to confer Weight to different types of nodes in the multiple project definition hierarchies. ",
-        "updated": 1624729793292
+        "text": "A type of vote within the Voting Program used to confer Weight to different types of nodes in the multiple Project Definition Hierarchies. The term is a generalization describing any or all of the types of weight vote nodes, namely Pool Weight Vote, Position Weight Vote, Feature Weight Vote, and Asset Weight Vote.",
+        "updated": 1630355074330
    },
    "paragraphs": [
        {
-            "style": "Text",
-            "text": "Right click and Edit to enter edit mode and change this text. ENTER to write new paragraphs. ESC to exit edit mode. Then you can use docs.save to save your changes and app.contribute to send it to the main repository."
+            "style": "Block",
+            "text": "Content",
+            "updated": 1630345048703
+        },
+        {
+            "style": "Important",
+            "text": "The Weight Power you drive into Weight Votes nodes is significant, as it is a measure of how much you wish to incentivize the referenced node. Nodes in Project Definition Hierarchies get Token Rewards proportional to the Weight Power they get from all Weight Votes they receive!",
+            "updated": 1630355171054
+        },
+        {
+            "style": "Success",
+            "text": "You may want to learn more about Token Rewards and Voting Power Flow!"
        }
    ]
 }
@@ -1,13 +1,26 @@
 {
    "type": "Asset Claim Vote",
    "definition": {
-        "text": "This node is used to pass votes, via a reference, to an Asset Contribution Claim made by a user, in order to support that claim and allow the user making the claim to receive tokens for contributing either with the creation of that an asset or it's mantainance.",
-        "updated": 1622988917379
+        "text": "Use this node to establish a reference with an Asset Contribution Claim placed by your colleague in the Claims Program section of their User Profile. This vote means that you support your colleague's claim with the Claim Support Power you drive into the Claim Votes node!",
+        "updated": 1630356280267
    },
    "paragraphs": [
        {
-            "style": "Text",
-            "text": "Right click and select the pencil button to enter edit mode."
+            "style": "Block",
+            "text": "Content",
+            "updated": 1630351012870
+        },
+        {
+            "style": "Include",
+            "text": "Governance->Concept->Reusable Governance Snippets->Claim Votes Content"
+        },
+        {
+            "style": "Block",
+            "text": "Configuration"
+        },
+        {
+            "style": "Title",
+            "text": "Configuration"
        }
    ]
 }
@@ -1,8 +1,8 @@
 {
    "type": "Asset Claims Folder",
    "definition": {
-        "text": "The Asset Claims Folder node is an organizational device used to arrange Asset Contribution Claim nodes in arbitrary arrangements or to map entire structures in the Assets hierarchy.",
-        "updated": 1630259461725
+        "text": "Use this node as an organizational device, to spawn Asset Contribution Claim nodes, and to map entire structures in an Assets hierarchy to place multiple Contribution Claims at once.",
+        "updated": 1630352114041
    },
    "paragraphs": [
        {
@@ -1,8 +1,8 @@
 {
    "type": "Asset Contribution Claim",
    "definition": {
-        "text": "Use this node to reference an Asset node in one of the Assets hierarchy to establish an Asset Contribution Claim.",
-        "updated": 1630324852856
+        "text": "Use this node to reference an Asset node in one of the Assets hierarchy to establish an Asset Contribution Claim. This claim means that you declare that you have worked on that Asset, either creating or improving it, and that you expect to be rewarded accordingly!",
+        "updated": 1630349414102
    },
    "paragraphs": [
        {
@@ -1,13 +1,26 @@
 {
    "type": "Asset Weight Vote",
    "definition": {
-        "text": "A Weight Vote that may reference an Asset node in the Assets hierarchy.",
-        "updated": 1624729908316
+        "text": "Use this node to establish a reference with an Asset node in an Assets hierarchy. With this vote, you are passing on Weight Power to the referenced node. That way, the node gets more of the Token Rewards available in the hierarchy. This is how you influence how different areas of the project are incentivized.",
+        "updated": 1630356598807
    },
    "paragraphs": [
        {
-            "style": "Text",
-            "text": "Right click and select the pencil button to enter edit mode."
+            "style": "Block",
+            "text": "Content",
+            "updated": 1630356862496
+        },
+        {
+            "style": "Include",
+            "text": "Governance->Concept->Weight Votes->Content"
+        },
+        {
+            "style": "Block",
+            "text": "Configuration"
+        },
+        {
+            "style": "Title",
+            "text": "Configuration"
        }
    ]
 }
@@ -1,8 +1,8 @@
 {
    "type": "Claim Votes Switch",
    "definition": {
-        "text": "This type of switch is used to spawn different types of claim vote nodes, and to reference “folder” type of nodes within the Claims Program section of the User Profile hierarchy.",
-        "updated": 1624729577011
+        "text": "Use this switch to spawn different types of Claim Votes, and to reference Claims Folder types of nodes within the Claims Program section of the User Profile hierarchy to map large structures of claims.",
+        "updated": 1630349853006
    },
    "paragraphs": [
        {
@@ -12,11 +12,38 @@
        },
        {
            "style": "Text",
-            "text": "When a Claim Votes Switch references any of the existing “folder” type of nodes (Position Contribution Claims Folder, Feature Contribution Claims Folder, or Asset Contribution Claims Folder), the Install Missing Votes option on the menu becomes usable."
+            "text": "You may use this switch for three different purposes:",
+            "updated": 1630345326820
+        },
+        {
+            "style": "List",
+            "text": "As an organizational device: You may create arbitrary arrangements of votes, spawning more switches and votes.",
+            "updated": 1630345425238
+        },
+        {
+            "style": "List",
+            "text": "As a switch: You may control the flow of Claim Support Power, pretty much like with the Token Power Switch, but within the Voting Program. If you need a reminder, read about how Token Power Flows.",
+            "updated": 1630355954531
+        },
+        {
+            "style": "List",
+            "text": "As a data-structure mapper: Use the node to reference Claims Folder types of nodes to map entire structures of claims on other User Profile hierarchies.",
+            "updated": 1630345729468
+        },
+        {
+            "style": "Text",
+            "text": "The first two use cases are self-explanatory. Let's explore the third one in more detail.",
+            "updated": 1630349876232
+        },
+        {
+            "style": "Callout",
+            "text": "Use a Claim Votes Switch node to establish a reference with a Claims Folder type of node — Position Claims Folder, Feature Claims Folder, or Asset Claims Folder — within the Claims Program section of your colleague's User Profile node. Then use the Install Missing Votes option on the menu of the Claim Votes Switch to map the entire Claims Folder! The process creates a Claim Votes Switch for each Claims Folder, and matching Claim Votes for each Asset Contribution Claim, Feature Contribution Claim, or Position Contribution Claim defined within each folder.",
+            "updated": 1630349946670
        },
        {
            "style": "Success",
-            "text": "Installing votes allows mapping entire sections of claim definitions so that you may vouch for multiple claims easily."
+            "text": "If something changes on the side of the definitions, you may always go back a run the Install Missing Votes process again. The process will remap the structure with the appropriate votes and switches.",
+            "updated": 1630348162382
        },
        {
            "style": "Block",
@@ -1,13 +1,26 @@
 {
    "type": "Feature Claim Vote",
    "definition": {
-        "text": "This node is used to pass votes, via a reference, to a Feature Contribution Claim made by a user, in order to support that claim and allow the user making the claim to receive tokens for contributing either with the creation of that an feature or it's mantainance.",
-        "updated": 1622988841078
+        "text": "Use this node to establish a reference with a Feature Contribution Claim placed by your colleague in the Claims Program section of their User Profile. This vote means that you support your colleague's claim with the Claim Support Power you drive into the Claim Votes node!",
+        "updated": 1630356075429
    },
    "paragraphs": [
        {
-            "style": "Text",
-            "text": "Right click and select the pencil button to enter edit mode."
+            "style": "Block",
+            "text": "Content",
+            "updated": 1630351115901
+        },
+        {
+            "style": "Include",
+            "text": "Governance->Concept->Reusable Governance Snippets->Claim Votes Content"
+        },
+        {
+            "style": "Block",
+            "text": "Configuration"
+        },
+        {
+            "style": "Title",
+            "text": "Configuration"
        }
    ]
 }
@@ -1,8 +1,8 @@
 {
    "type": "Feature Claims Folder",
    "definition": {
-        "text": "The Feature Claims Folder node is an organizational device used to arrange Feature Contribution Claim nodes in arbitrary arrangements or to map entire structures in the Features hierarchy.",
-        "updated": 1630260148773
+        "text": "Use this node as an organizational device, to spawn Feature Contribution Claim nodes, and to map entire structures in a Features hierarchy to place multiple Contribution Claims at once.",
+        "updated": 1630352152356
    },
    "paragraphs": [
        {
@@ -1,8 +1,8 @@
 {
    "type": "Feature Contribution Claim",
    "definition": {
-        "text": "Use this node to reference a Feature node in one of the Features hierarchy to establish a Feature Contribution Claim.",
-        "updated": 1630325556674
+        "text": "Use this node to reference a Feature node in one of the Features hierarchy to establish a Feature Contribution Claim. This claim means that you declare that you have worked on that Feature, either creating or improving it, and that you expect to be rewarded accordingly!",
+        "updated": 1630349366359
    },
    "paragraphs": [
        {
@@ -1,13 +1,26 @@
 {
    "type": "Feature Weight Vote",
    "definition": {
-        "text": "A Weight Vote that may reference a Feature node in the Features hierarchy.",
-        "updated": 1624729893680
+        "text": "Use this node to establish a reference with a Feature node in a Features hierarchy. With this vote, you are passing on Weight Power to the referenced node. That way, the node gets more of the Token Rewards available in the hierarchy. This is how you influence how different areas of the project are incentivized.",
+        "updated": 1630356636079
    },
    "paragraphs": [
        {
-            "style": "Text",
-            "text": "Right click and select the pencil button to enter edit mode."
+            "style": "Block",
+            "text": "Content",
+            "updated": 1630356880239
+        },
+        {
+            "style": "Include",
+            "text": "Governance->Concept->Weight Votes->Content"
+        },
+        {
+            "style": "Block",
+            "text": "Configuration"
+        },
+        {
+            "style": "Title",
+            "text": "Configuration"
        }
    ]
 }
@@ -1,13 +1,27 @@
 {
    "type": "Pool Weight Vote",
    "definition": {
-        "text": "A Weight Vote that may reference a Pool node in the Pools hierarchy.",
-        "updated": 1624729823524
+        "text": "Use this node to establish a reference with a Pool node in a Pools hierarchy. With this vote, you are passing on Weight Power to the referenced node. That way, the node gets more of the Token Rewards available in the hierarchy. This is how you influence how different areas of the project are incentivized.",
+        "updated": 1630356667487
    },
    "paragraphs": [
        {
-            "style": "Text",
-            "text": "Right click and select the pencil button to enter edit mode."
+            "style": "Block",
+            "text": "Content",
+            "updated": 1630356719004
+        },
+        {
+            "style": "Include",
+            "text": "Governance->Concept->Weight Votes->Content",
+            "updated": 1630356837090
+        },
+        {
+            "style": "Block",
+            "text": "Configuration"
+        },
+        {
+            "style": "Title",
+            "text": "Configuration"
        }
    ]
 }
@@ -1,13 +1,27 @@
 {
    "type": "Position Claim Vote",
    "definition": {
-        "text": "This node is used to pass votes, via a reference, to a Position Claim made by a user, in order to support that claim and allow the user making the claim to receive tokens for playing a role at the said position.",
-        "updated": 1622988653975
+        "text": "Use this node to establish a reference with a Position Contribution Claim placed by your colleague in the Claims Program section of their User Profile. This vote means that you support your colleague's claim with the Claim Support Power you drive into the Claim Votes node!",
+        "updated": 1630356265895
    },
    "paragraphs": [
        {
-            "style": "Text",
-            "text": "Right click and select the pencil button to enter edit mode."
+            "style": "Block",
+            "text": "Content",
+            "updated": 1630350078214
+        },
+        {
+            "style": "Include",
+            "text": "Governance->Concept->Reusable Governance Snippets->Claim Votes Content",
+            "updated": 1630350813522
+        },
+        {
+            "style": "Block",
+            "text": "Configuration"
+        },
+        {
+            "style": "Title",
+            "text": "Configuration"
        }
    ]
 }
@@ -1,8 +1,8 @@
 {
    "type": "Position Claims Folder",
    "definition": {
-        "text": "The Position Claims Folder node is an organizational device used to arrange Position Contribution Claim nodes in arbitrary arrangements or to map entire structures in the Positions hierarchy.",
-        "updated": 1630260192942
+        "text": "Use this node as an organizational device, to spawn Position Contribution Claim nodes, and to map entire structures in a Positions hierarchy to place multiple Contribution Claims at once.",
+        "updated": 1630352182572
    },
    "paragraphs": [
        {
@@ -1,8 +1,8 @@
 {
    "type": "Position Contribution Claim",
    "definition": {
-        "text": "Use this node to reference a Position node in one of the Positions hierarchy to establish a Position Contribution Claim.",
-        "updated": 1630325495738
+        "text": "Use this node to reference a Position node in one of the Positions hierarchy to establish a Position Contribution Claim. This claim means that you declare that you have worked on that Position, and that you expect to be rewarded accordingly!",
+        "updated": 1630349455755
    },
    "paragraphs": [
        {
@@ -1,13 +1,26 @@
 {
    "type": "Position Weight Vote",
    "definition": {
-        "text": "A Weight Vote that may reference a Position node in the Positions hierarchy.",
-        "updated": 1624729877473
+        "text": "Use this node to establish a reference with a Position node in a Positions hierarchy. With this vote, you are passing on Weight Power to the referenced node. That way, the node gets more of the Token Rewards available in the hierarchy. This is how you influence how different areas of the project are incentivized.",
+        "updated": 1630356651483
    },
    "paragraphs": [
        {
-            "style": "Text",
-            "text": "Right click and select the pencil button to enter edit mode."
+            "style": "Block",
+            "text": "Content",
+            "updated": 1630356906843
+        },
+        {
+            "style": "Include",
+            "text": "Governance->Concept->Weight Votes->Content"
+        },
+        {
+            "style": "Block",
+            "text": "Configuration"
+        },
+        {
+            "style": "Title",
+            "text": "Configuration"
        }
    ]
 }
@@ -11,7 +11,7 @@
            "updated": 1624729535872
        },
        {
-            "style": "Text",
+            "style": "Important",
            "text": "This node can not reference “class” or “folder” types of nodes on other hierarchies. It is merely an organizational device."
        },
        {
@@ -1,8 +1,8 @@
 {
    "type": "Voting Program",
    "definition": {
-        "text": "The Voting Program is the heart and soul of governance, as it is the section of the hierarchy Contributors use to cast various types of votes. The program is designed to incentivize participation. For that reason, voting earns you tokens too!",
-        "updated": 1624729344266
+        "text": "The Voting Program is the heart and soul of governance, as it enables you to cast various types of votes. You may decide what to incentivize, weighing Pools, Assets, Features, and Positions. You may also evaluate and support Contribution Claims and transfer Voting Power to other users.",
+        "updated": 1630351287920
    },
    "paragraphs": [
        {
@@ -11,48 +11,52 @@
            "updated": 1624729363885
        },
        {
-            "style": "Text",
-            "text": "At the time of each Distribution Event, your Voting Power — that is, the Token Power you assign to the Voting Program — determines the Direct Proportion of tokens you get from the Voting Program Pool."
+            "style": "Include",
+            "text": "Governance->Concept->Reusable Governance Snippets->Featuring Tokens Bonus",
+            "updated": 1630329521827
        },
        {
            "style": "Text",
-            "text": "A top-level Votes Switch node allows spawning several other particular switches. A switch allows channeling Voting Power in a specific direction and a specific proportion."
-        },
-        {
-            "style": "Text",
-            "text": "By default, the Votes Switch node passes on an equal amount of Voting Power to its offspring. However, you may override the percentage of Voting Power allocated to each switch below a Votes Switch by using the following parameter in the configuration of the particular switch:"
-        },
-        {
-            "style": "Json",
-            "text": "{\n    \"percentage\": 50\n}",
-            "updated": 1624729399791
-        },
-        {
-            "style": "Text",
-            "text": "If you define less than a total of 100% of the Voting Power flowing at any level of the hierarchy, then the remaining Voting Power is distributed evenly across the rest of the offspring at the same level.",
-            "updated": 1624729413463
-        },
-        {
-            "style": "Text",
-            "text": "There are three categories of votes, each with their corresponding switch that helps organize votes in hierarchical structures:"
+            "text": "The features in the Voting Program allow you to cast three different categories of votes:",
+            "updated": 1630344509716
        },
        {
            "style": "List",
-            "text": "Claim Votes Switch;"
+            "text": "Claim Votes: Use Claim Votes to support the claims of other users so that they may get the rewards they deserve for their contributions. There are three types of claim vote nodes, namely Asset Claim Vote, Feature Claim Vote, and Position Claim Vote nodes.",
+            "updated": 1630344722135
        },
        {
            "style": "List",
-            "text": "Weight Votes Switch;"
+            "text": "Weight Votes: Use Weight Votes to influence what areas of the project should be incentivized. There are four types of weight votes, namely Pool Weight Vote, Asset Weight Vote, Feature Weight Vote, and Position Weight Vote nodes.",
+            "updated": 1630344790466
        },
        {
            "style": "List",
-            "text": "User Profile Votes Switch",
-            "updated": 1624735526746
+            "text": "User Profile Votes: Use a User Profile Vote to transfer Voting Power to other users.",
+            "updated": 1630344853204
+        },
+        {
+            "style": "Text",
+            "text": "There is a top-level Votes Switch node that allows spawning several other switches, each one associated to the different types of votes described above:",
+            "updated": 1630343139964
+        },
+        {
+            "style": "List",
+            "text": "Claim Votes Switch",
+            "updated": 1630329624666
+        },
+        {
+            "style": "List",
+            "text": "Weight Votes Switch"
+        },
+        {
+            "style": "List",
+            "text": "User Profile Votes Switch"
        },
        {
            "style": "Success",
-            "text": "Each switch may spawn specialized types of voting nodes, each with the capacity of casting votes towards specific types of nodes on other hierarchies. The Token Rewards and Voting Power Flow page in the Governance Flow topic covers important details of how Votes work. Make sure you read the whole topic!",
-            "updated": 1624735504965
+            "text": "These switches control the flow of Voting Power, may be used as organizational devices, may spawn the different types of votes, and may help you map entire data structures easily. Find the details on the page of each switch!",
+            "updated": 1630348670996
        },
        {
            "style": "Block",
@@ -1,8 +1,8 @@
 {
    "type": "Weight Votes Switch",
    "definition": {
-        "text": "This type of switch is used to spawn different types of weight vote nodes, and to reference “class” type of nodes within the different hierarchies that define Project incentives.",
-        "updated": 1624729654009
+        "text": "Use this switch to spawn different types of Weight Votes, and to reference Class types of nodes within any of the Project Definition Hierarchies to map large structures of definitions.",
+        "updated": 1630356971950
    },
    "paragraphs": [
        {
@@ -12,11 +12,32 @@
        },
        {
            "style": "Text",
-            "text": "When a Weight Votes Switch references any of the existing “class” type of nodes in the Pools, Positions, Features, and Assets hierarchies, the Install Missing Votes option on the menu becomes usable."
+            "text": "You may use this switch for three different purposes:"
+        },
+        {
+            "style": "List",
+            "text": "As an organizational device: You may create arbitrary arrangements of votes, spawning more switches and votes."
+        },
+        {
+            "style": "List",
+            "text": "As a switch: You may control the flow of Weight Power, pretty much like the with a Token Power Switch, but within the Voting Program. If you need a reminder, read about how Token Power Flows.",
+            "updated": 1630357007626
+        },
+        {
+            "style": "List",
+            "text": "As a data-structure mapper: Use the node to reference Class types of nodes within Project Definition Hierarchies to map entire structures of definitions."
+        },
+        {
+            "style": "Text",
+            "text": "The first two use cases are self-explanatory. Let's explore the third one in more detail."
+        },
+        {
+            "style": "Callout",
+            "text": "Use a Weight Votes Switch node to establish a reference with a Class type of node — Pool Class, Position Class, Feature Class, or Asset Class — within Project Definition Hierarchies. Then use the Install Missing Votes option on the menu of the Weight Votes Switch to map the entire Class section of the hierarchy! The process creates a Weight Votes Switch for each Class type of node, and matching Weight Votes for each Asset, Feature, Position, or Pool defined within each Class node."
        },
        {
            "style": "Success",
-            "text": "Installing votes allows mapping entire sections of project definitions so that you may vote to incentivize multiple definitions easily."
+            "text": "If something changes on the side of the definitions, you may always go back a run the Install Missing Votes process again. The process will remap the structure with the appropriate votes and switches."
        },
        {
            "style": "Block",
@@ -23,11 +23,13 @@
        },
        {
            "style": "Text",
-            "text": "This is where Token Rewards intersect with Voting Power, as it is Voting Power that drives Token Rewards."
+            "text": "This is where Token Rewards intersect with Voting Power, as it is Voting Power that drives Token Rewards through Weight Votes.",
+            "updated": 1630343425368
        },
        {
            "style": "Text",
-            "text": "Your Token Power flows into the different programs available under your User Profile. The portion of Token Power that flows into your Voting Program turns into Voting Power, which is channeled through different types of switches. You use Weight Vote Switch nodes to turn Voting Power into Weight Votes."
+            "text": "Your Token Power flows into the different programs available under your User Profile. The portion of Token Power that flows into your Voting Program turns into Voting Power, which is channeled through different types of switches. You use Weight Votes Switch nodes to turn Voting Power into Weight Votes.",
+            "updated": 1630343456190
        },
        {
            "style": "Text",
@@ -44,8 +46,8 @@
        },
        {
            "style": "Json",
-            "text": "Weight (of a node) = Node’s Incoming Weight Votes / Sum of Weight Votes in the Hierarchy * 100",
-            "updated": 1624781181588
+            "text": "Weight (of a node) = Node's Incoming Weight Votes / \n                      Sum of Weight Votes in the Hierarchy * 100",
+            "updated": 1630343557835
        },
        {
            "style": "Note",