steemit / devportal

Steem Platform Developer Documentation.
https://developers.steem.io
MIT License
122 stars 74 forks source link

TN: Add More "Why" Details to Estimate Upvote #386

Open inertia186 opened 5 years ago

inertia186 commented 5 years ago

As an applocation developer, I would like to know more about each component involved in calculating an upvote so that I can understand what I'm calculating.

Specifically, the final calculation:

https://github.com/steemit/devportal/blame/88368fe89f62759edd37ea5efd0dce4e20345066/_tutorials-recipes/estimate_upvote.md#L200-L204

For example, instead of just saying "calculating value of each vote depends on multiple factors", more details should be added, like:

We use delegated_vesting_shares but why? If you do not account for this, the caclulation will be thrown off because delegated_vesting_shares is STEEM Power that has been delegated to someone else and cannot be included as part of total_vests. If it's not accounted for in the calculation (and it's non-zero), the estimated upvote would be higher than it should be.

(extends: #157)

AC