arc icon indicating copy to clipboard operation
arc copied to clipboard

Document GenesisProtocol parameters

Open dkent600 opened this issue 7 years ago • 2 comments

Arc documentation says nothing about the function of any of the GenesisProtocol parameters. The solidity code contains cursory documentation, but not sufficient. It would be better if edited for English, provided units (like Wei, seconds, etc), and described all the referenced concepts, for example "threshold" and "quite ending".

dkent600 avatar Mar 26 '18 14:03 dkent600

Particularly needing further explanation are all four constant A and B params (what do they really mean in concrete terms relating to a proposal vote?), and votersReputationLossRatio and votersGainRepRatioFromLostRep.

dkent600 avatar Mar 26 '18 15:03 dkent600

Here are the Arc docs on this: https://daostack.github.io/arc.js/api/interfaces/GenesisProtocolParams/

These can be improved too, at minimum because they lack some of the information I'm asking for above in the Arc docs. Comments invited.

dkent600 avatar Mar 26 '18 19:03 dkent600