Add primer on governor

products/governor.md

@@ -1,8 +1,20 @@
 ---
-description: "\U0001F6A7\U0001F477 IN PROGRESS \U0001F477\U0001F6A7"
+description: "Decentralise DAO governance control securely"
 ---
 
 # Governor
+Kleros Governor is a smart contract that allows for the effecting of DAO governance decisions to be decentralized without compromising security. By designating Kleros Governor as the governor contract for your DAO, batches of transactions representing governance decisions can be submitted as lists to Kleros Governor. In case of disputes about the validity of the submitted transactions, Kleros's jury network will step in to arbitrate the dispute.
 
-🔍 [Kleros Governor App](https://governor.kleros.io/) 🔍
+## How does it work?
+The first step to using Kleros Governor is to point to it as the governor contract for your DAO. 
+Each Governor session enforces governance decisions that were passed prior to the start of the current session, which can be organised on a platform like [Snapshot](https://snapshot.org/).
+
+Once a decision has been reached, a (technically inclined) user then needs to translate the decision into a list of transactions and submit them for execution by the governor contract. If there is only one list submitted in the challenge period, it will be accepted and the deposit is returned to the submitter.
+
+If a competing list is submitted in the same session, a dispute will be automatically created in Kleros Court, and jurors will get to choose which list is correct. After dispute resolution concludes, the deposit from the losing list will be used to pay the jurors and reward the user that submitted the winning list.
+
+Lists that most completely enforce the greatest number of governance decisions will be accepted. The process for choosing between lists can be seen [here](https://ipfs.kleros.io/ipfs/QmPt2oTHCYZYUShuLxiK4QWH6sXPHjvgXTqMDpCShKogQY/KlerosGovernorPrimaryDocument.pdf). 
+
+
+🏛 [Kleros Governor App](https://governor.kleros.io/) 🏛
 

products/oracle.md

@@ -8,7 +8,7 @@ description: >-
 
 Kleros Oracle is a product combining Kleros dispute resolution with Reality.eth cryptoeconomic mechanism for verifying real world events on-chain, to deliver a subjective oracle solution able to answer absolutely any question with a publicly verifiable answer.
 
-### How does it work?
+## How does it work?
 
 Anyone \(individual or dapp\) can submit a question to the Reality.eth platform while specifying Kleros as the final arbitrator. For example:
 

products/proof-of-humanity.md

@@ -16,7 +16,7 @@ Building this type of advanced identity registry is not an end in itself. It is
 
 ## Proof of Humanity Use Cases <a id="proof-of-humanity-use-cases"></a>
 
-#### Universal Basic Income <a id="universal-basic-income"></a>
+### Universal Basic Income <a id="universal-basic-income"></a>
 
 Universal basic income \(UBI\) is a program for a periodic payment delivered to all individuals of a given population with no strings attached.
 
@@ -26,27 +26,27 @@ A UBI project based on Proof of Humanity is already underway as a collaboration
 
 Check out the [_announcement of the UBI token launch_](https://blog.kleros.io/proof-of-humanity-building-the-internet-of-humans/) to learn more about this.
 
-#### Innovative DAO frameworks <a id="innovative-dao-frameworks"></a>
+### Innovative DAO frameworks <a id="innovative-dao-frameworks"></a>
 
 DAO frameworks and apps using the PoH registry to check the “humanity” of voters can experiment with truly democratic systems \(1 person = 1 vote\) and innovative preferential or quadratic voting features for which Sybil-resistance is required.
 
 For example, the UBI DAO will be based on a governance system such as this one in order to better account for the voices of every community member. A similar system could be added as a plugin to common DAO tools such as Colony, Aragon, or DAOstack.
 
-#### Better Funding Mechanisms <a id="better-funding-mechanisms"></a>
+### Better Funding Mechanisms <a id="better-funding-mechanisms"></a>
 
 By extending the concept of Quadratic Voting to a funding mechanism, one can create new mechanisms for endogenous community formation. [Quadratic funding](https://wtfisqf.com/) is a design for philanthropic or publicly-funded seeding to allow \(near\) optimal provision of a decentralized, self-organizing ecosystem of public goods.
 
 Citizens make public goods contributions to projects of value to them. The amount received by a project is proportional to the square of the sum of the square roots of contributions received.
 
 This mechanism requires accounts to be Sybil-resistant as splitting one’s funding across multiple accounts increases the amount given to the target project. And Proof of Humanity allows for this Sybil-resistance. Proof of Humanity can be an important piece of infrastructure to bring into reality some of the innovative governance ideas explained in the book "Radical Markets". For example, quadratic voting.
 
-#### Universal Identifiers and Self-Sovereign Identities <a id="universal-identifiers-and-self-sovereign-identities"></a>
+### Universal Identifiers and Self-Sovereign Identities <a id="universal-identifiers-and-self-sovereign-identities"></a>
 
 Accounts created on PoH can directly be used as a universal login method: imagine dapps recognizing users automatically without the need for registration.
 
 They can also be associated with other existing identity-adjacent systems such as 3box, ENS, or Serto.id to add Sybil-resistance to a user's profile.
 
-#### Certification and Reputation Systems <a id="certification-and-reputation-systems"></a>
+### Certification and Reputation Systems <a id="certification-and-reputation-systems"></a>
 
 Various certifications or reputation points \(such as credit scoring\) could be added to PoH profiles.
 
@@ -58,23 +58,23 @@ Certifications can include:
 * Degrees and professional certifications
 * Skills \(for example an “experienced Solidity developer” badge which could be assessed by looking at open source code published by the individual\)
 
-#### Sybil-Resistant Airdrops, Yield Farming, and NFT Distribution <a id="sybil-resistant-airdrops-yield-farming-and-nft-distribution"></a>
+### Sybil-Resistant Airdrops, Yield Farming, and NFT Distribution <a id="sybil-resistant-airdrops-yield-farming-and-nft-distribution"></a>
 
 Airdrops are a popular way to distribute tokens. However, even when requiring different forms of identification \(telegram accounts, passports\), those airdrops were typically Sybil-attacked.
 
 This led to a switch toward airdrops proportional to the user balance of a specific coin and lock drops \(where users need to lock some coins and receive tokens proportionally\). Those techniques, despite being Sybil-resistant, benefit users already having a high amount of crypto-holdings.
 
 Proof Of Humanity will allow Sybil-resistant airdrops where participants will each be given the same amount of coins. The same method can be applied to Sybil-resistant yield-farming \(UBI token accrual, for example\); to ensure gift NFTs are not hoarded by a small minority, or to ensure free subscription schemes are not abused.
 
-#### Anti-Spam Tools <a id="anti-spam-tools"></a>
+### Anti-Spam Tools <a id="anti-spam-tools"></a>
 
 Systems often use captchas \(small exercises testing user capacity to analyze an image or a sound which are hard to complete for AIs\) before allowing a user action in order to prevent spam.
 
 These are wasting user time and do not prevent spam from a determined user who would be willing to spend the time to solve them \(or outsource the solution\). People in the PoH registry could be allowed a number of captcha-free interactions \(potentially high enough such that they never have to fill a captcha\).
 
 Users spamming the system could get temporarily or permanently banned. And they would not be able to just create a new account in order to evade the ban.
 
-#### Sidechains Secured by Proof-of-Humanity Consensus <a id="sidechains-secured-by-proof-of-humanity-consensus"></a>
+### Sidechains Secured by Proof-of-Humanity Consensus <a id="sidechains-secured-by-proof-of-humanity-consensus"></a>
 
 The PoH registry could also be used to create a novel type of sidechain secured by Proof Of Identity with a “1 person = 1 vote” principle. This would assume an honest majority of humans in the registry and would work in a way similar to Proof Of Authority sidechains.