Update mechanism.md

source/mechanism.md

@@ -1,46 +1,46 @@
 # Decentralized trading protocol for ERC20 tokens
 
-The DutchX switches between two states (for each token pair):  
-(1) the batching before an auction starts (for sellers to deposit their tokens), and  
-(2) the running Dutch auction (when bidders are active).  
+The DutchX switches between two states (for each token pair):<br/>
+(1) the batching before an auction starts (for sellers to deposit their tokens), and<br/>
+(2) the running Dutch auction (when bidders are active).
 
 Sellers can submit the tokens they would like to sell at any point in time. Those will automatically be placed into the next available auction — no tokens can be submitted into the running auction.  
 
 Bidders are only active during the running of an auction.  
 
-There is always only one auction per token pair running (with opposite auctions running simultaneously). All auctions run independent of one another.  
+There is always only one auction per token pair running (with opposite auctions running simultaneously). All auctions run independent of one another.<br/>  
 When an auction for a token-pairing starts, the initial price is set at twice the final closing price of the previous auction (of the same pairing). From this initial price, the price falls according to a decreasing function. During the auction, when bidders are active, they submit their bid at any point in time at that current price (remember: the price function is decreasing). The bidders are guaranteed the minimum amount of tokens at the price point at which they took part. Bidders can submit bids until the auction closes (where bidVolume x price = sellVolume). Note that all bidders receive the same final and therefore lowest price. Bidders should therefore take part where the current price of the auction reflects their maximum willingness to pay.
 Since bidders will only pay the final market clearing price, which is either at their bid or lower, they have an economic incentive to submit the bid at their highest willingness to pay.
 
-Check the section on **interfaces** for ways to participate.  
+Check the section on [**interfaces**](https://dutchx.readthedocs.io/en/latest/interfaces.html) for ways to participate.  
 
 ## Liquidity contribution
-On the DutchX Protocol, liquidity contribution is levied on users in place of traditional fees.
-**These do not go to anyone** (not to Gnosis, or any other party):
-Liquidity contribution is committed to the next running auction for the respective auction pair and are thus *redistributed to all users of the DutchX protocol*! It incentivises volume and use of the protocol.  
-
-Your individual liqudity contribution depends on your amount of Magnolia token held as a percentage of the entire Magnolia market (it is a step function):  
-=>10% of Magnolia held --> 0.1% liquidity contribution  
-1%-10% of Magnolia held --> 0.2% of liquidity contribution  
-0.1%-1% of Magnolia held --> 0.3% of liquidity contribution   
-0.01%-0.1% of Magnolia held --> 0.4% of liquidity contribution  
+On the DutchX Protocol, liquidity contribution is levied on users in place of traditional fees.<br/>
+**These do not go to anyone** (not to Gnosis, or any other party):<br/>
+Liquidity contribution is committed to the next running auction for the respective auction pair and are thus *redistributed to all users of the DutchX protocol*! It incentivises volume and use of the protocol.<br/>
+
+Your individual liqudity contribution depends on your amount of Magnolia token held as a percentage of the entire Magnolia market (it is a step function):<br/>  
+=>10% of Magnolia held --> 0.1% liquidity contribution<br/>  
+1%-10% of Magnolia held --> 0.2% of liquidity contribution<br/>  
+0.1%-1% of Magnolia held --> 0.3% of liquidity contribution<br/>   
+0.01%-0.1% of Magnolia held --> 0.4% of liquidity contribution<br/>  
 anything below 0.01% of Magnolia held --> 0.5% of liquidity contribution.  
 
  **The liquidity contribution could also be positive** for a trader that has lower contribution than other traders in the same pair!
 
 ## Magnolia
-Magnolia (MGN) tokens are intrinsic to the DutchX and lower the default liquidity contribution on the DutchX Protocol.  
-MGN are automatically generated and credited to users: 1 MGN is credited for trading 1 ETH worth of any whitelisted token pair (and of course trading any fraction of ETH generates the same fraction of MGN).
-MGN are locked by default into a smart contract for which the user’s address is associated with a particular balance.  
-A user may unlock all Magnolia associated with an address at once and after 24 hours have passed, these tokens may be transferred to another address. The new holder must then lock their tokens again (or a subset thereof) in order to use the Magnolia balance for liquidity contribution reduction.  
-Magnolia are inflationary, which should incentivise an early adoption and continuous use of the DutchX protocol.  
+Magnolia (MGN) tokens are intrinsic to the DutchX and lower the default liquidity contribution on the DutchX Protocol.<br/>  
+MGN are automatically generated and credited to users: 1 MGN is credited for trading 1 ETH worth of any whitelisted token pair (and of course trading any fraction of ETH generates the same fraction of MGN).<br/>
+MGN are locked by default into a smart contract for which the user’s address is associated with a particular balance.<br/>  
+A user may unlock all Magnolia associated with an address at once and after 24 hours have passed, these tokens may be transferred to another address. The new holder must then lock their tokens again (or a subset thereof) in order to use the Magnolia balance for liquidity contribution reduction.<br/>  
+Magnolia are inflationary, which should incentivise an early adoption and continuous use of the DutchX protocol.<br/>  
 Magnolia are not needed to participate as a seller or bidder on the DutchX.
 
 ## Whitelist
-Whitelisted tokens are those that have the potential to generate Magnolia when traded in a whitelisted pair. The idea of whitelisted tokens is that no token can be added to the DutchX Protocol with the mere intention to create Magnolia and benefit from liquidity contributions.
-Whitelisting will - in future - be decided by the DAO.  
-This is the complete list of the [currently whitelisted tokens](https://github.com/gnosis/dx-contracts/blob/master/test/resources/approve-tokens/dxDAO_approved_tokens.js) (as per February 2019).  
-They were selected based on a legal assessment of token characteristics, which suggest that legislation of major jurisdictions regulating securities, financial instruments or similar and/or mandating customer due diligence procedures do not apply to them at this point in time for the purposes of the DutchX protocol.
+Whitelisted tokens are those that have the potential to generate Magnolia when traded in a whitelisted pair. The idea of whitelisted tokens is that no token can be added to the DutchX Protocol with the mere intention to create Magnolia and benefit from liquidity contributions.<br/>
+Whitelisting will - in future - be decided by the DAO.<br/>  
+This is the complete list of the [currently whitelisted tokens](https://github.com/gnosis/dx-contracts/blob/master/test/resources/approve-tokens/dxDAO_approved_tokens.js) (as per February 2019).<br/>  
+They were selected based on a legal assessment of token characteristics, which suggest that legislation of major jurisdictions regulating securities, financial instruments or similar and/or mandating customer due diligence procedures do not apply to them at this point in time for the purposes of the DutchX protocol.<br/>
 Regardless of being whitelisted, tokens will still first need to be added to the protocol before trading is possible.  
 
 Note that whitelisted tokens are not the same as **listed** and **traded** tokens. A whitelisted token has the potential to create Magnolia tokens (used for reduction of liquidity contribution) if traded in a whitelisted pair. Tokens can be listed for trading on the DutchX protocol, albeit not whitelisted (and hence trades do not generate Magnolia); on the flip side, tokens could be whitelisted, however not listed/traded on the DutchX protocol.
@@ -58,7 +58,7 @@ In version DutchX 2.0, OWL is part of the DutchX Protocol:
 
 ### What is OWL used for on the DutchX?
 - Useres *may* use OWL to settle half of their liquidity contribution. The rest is settled in the token they are taking part in.
-- This does not affect liquidity contribution reduction. The reduction happens first, *then* half may be settled in OWL
+- This does not affect liquidity contribution reduction. The reduction happens first, *then* half may be settled in OWL.
 - 1 OWL is treated as an equivalent of 1USD worth of fees.
 - The OWL used will not go to **any party** but will instead be burnt (consumed).   
 
@@ -74,7 +74,7 @@ In version DutchX 2.0, OWL is part of the DutchX Protocol:
 - You might be able to acquire it for less than 1USD worth and would hence reduce your liquidity contribution!
 
 ### How does one get OWL?
-- See above, there was an initial generation. There is no generation ongoing.
+- There is no generation ongoing. Check [this website](https://owl.gnosis.io/) to see prior generations and claim back your GNO if you haven't done so already.
 - Stay tuned for further generation announcement on public channels. For this, one needs GNO.
 - OWL may be traded on secondary markets or OTC.
 
@@ -101,4 +101,4 @@ Specifically, however, there are two reasons that make upgrade by hard-forks onl
 In the first version of the DutchX smart contracts, these auctioneer powers were relinquished. This meant that **neither Gnosis nor anyone else**, had the ability to alter the contracts parameters or logic.
 
 ### Who holds auctioneer powers to DutchX 2.0?
-The primary aim with this  deployment is to provide the dxDAO (when it is ready) with the auctioneer powers of the DutchX. Until then, projects can already start integrating on this final version as the DutchX 2.0 will remain unaltered. Tokens will be whitelisted before the hand-over.
+The primary aim with this  deployment is to provide the [dxDAO](https://dutchx.readthedocs.io/en/latest/dxDAO.html) with the auctioneer powers of the DutchX. Until then, projects can already start integrating on this final version as the DutchX 2.0 will remain unaltered.