Document V1 changes

[maurolacy]

TODO:

• Slashing behaviour / impl.
• MS V1 limitations / design decisions.
• Osmosis price oracle contract.
• ...