This is my contribution to Superalgos

Projects/Governance/Schemas/Docs-Nodes/P/Pool/Pool/pool.json

@@ -1,13 +1,54 @@
 {
     "type": "Pool",
     "definition": {
-        "text": "A Pool represents the highest level container of tokens.  They are used to route tokens to specific hierarchies via references. Users votes on pools to influence how many tokens will be routed and then distributed at the referenced hierarchy.",
-        "updated": 1622985663794
+        "text": "A Pool represents a high-level container of Token Rewards. The node is used to receive Weight Votes and to route tokens to other hierarchies via references. Contributors may direct Weight Votes to Pool nodes to affect how many tokens will be routed to and distributed at the referenced hierarchy.",
+        "updated": 1624707171824
     },
     "paragraphs": [
+        {
+            "style": "Block",
+            "text": "Content",
+            "updated": 1624707200475
+        },
         {
             "style": "Text",
-            "text": "Right click and select the pencil button to enter edit mode."
+            "text": "Pool nodes may be nested in arbitrary levels and may be arranged under Pool Class nodes or directly under other Pool nodes. When they reference another hierarchy, the definition of the organization of the Project continues in the said hierarchy."
+        },
+        {
+            "style": "Text",
+            "text": "When you direct Weight Votes into a Pool node, you are effectively increasing the weight of the pool in the eventual distribution of tokens by the number of votes you are directing to it. The Pool will get a portion of the tokens assigned to the Pools hierarchy in proportion to the total number of incoming Weight Votes. If a Pool has no incoming Weight Votes, it gets zero tokens."
+        },
+        {
+            "style": "Text",
+            "text": "Pool nodes with incoming Weight Votes display the following pieces of information:"
+        },
+        {
+            "style": "List",
+            "text": "Number of Votes: the total number of Weight Votes directed at the node."
+        },
+        {
+            "style": "List",
+            "text": "Number of Tokens Awarded: the total number of tokens the Pool gets for the votes it has."
+        },
+        {
+            "style": "List",
+            "text": "Weight: The total weight of the Pool is expressed as a percentage of the total Weight Votes directed at the whole hierarchy."
+        },
+        {
+            "style": "Callout",
+            "text": "Notice that Pool nodes participate in the pool of tokens assigned to the Pools hierarchy it belongs to. The aforementioned Weight value is in relation to the said hierarchy, and not necessarily to the top-level Superalgos Pools hierarchy."
+        },
+        {
+            "style": "Text",
+            "text": "We mentioned that Pool nodes may pass on Token Rewards to other hierarchies which, in turn, further break up the definitions of where tokens go to. We’ll explore those hierarchies in the next few pages."
+        },
+        {
+            "style": "Block",
+            "text": "Configuration"
+        },
+        {
+            "style": "Title",
+            "text": "Configuration"
         }
     ]
 }