Improvement suggestion for dao-user-reference.adoc

[huey735]

Provide more detail regarding voting weight

@ManfredKarrer @cbeams @m52go

Voting Stake
Your voting weight is determined by 2 factors: reputation (how much BSQ you’ve earned), and stake (how much of your owned BSQ you allot to your vote) that you specify in your vote transaction.
(...)

Let's Alice earns 10 000 BSQ in cycle 1 and Bob bought 10 000 BSQ in cycle 1.

• What's the reputation equation?
• How is the time calculated? In blocks? 1 day = 144 blocks and so forth?
• In cycle 2, if Alice has only 10 BSQ left after having sold the rest, can she spend 2 on the voting fee, stake 8 and still retain the 10 000 vote weight? What's the minimum value to stake and retain the reputation weight?
• How is Alice's reputation tracked?

[m52go]

Practically, stake should linearly decay to zero in 24 months. Exact workings of the merit calculations are in the code here.

Time is calculated in blocks, with 50,000 assumed to be the number of blocks per year.

After 1 month, Alice would retain ~9583 BSQ of merit voting weight. She should be able to stake any amount of BSQ over the dust limit (5.47 I think?) and be able to make a vote transaction. Any vote transaction she makes, regardless of how much she stakes, will include that ~9583 BSQ voting merit weight.

I think only Manfred would know this. I get the impression it's calculated when a blind vote transaction is made.

[m52go]

Your questions are excellent, but I wonder if we should add such specific details to the documentation?

[huey735]

I think that it's important for it to be clear how much weight each person has or needs when voting to effect change.