Merge pull request #3068 from oasisprotocol/pro-wh/feature/votingpowe…

…rdocs docs: add voting power description
oasisprotocol · Jun 30, 2020 · ad88d22 · ad88d22
2 parents da7813e + 1f7e433
commit ad88d22
Show file tree

Hide file tree

Showing 2 changed files with 14 additions and 0 deletions.
diff --git a/.changelog/3068.trivial.md b/.changelog/3068.trivial.md
diff --git a/docs/consensus/scheduler.md b/docs/consensus/scheduler.md
@@ -16,3 +16,17 @@ the [consensus service API documentation].
 <!-- markdownlint-enable line-length -->
 
 ## Events
+
+## Validator Committee
+
+When the committee scheduler schedules the validator committee, it additionally
+assigns each member a _voting power_, which controls (i) the weight of its
+votes in the consensus protocol and (ii) how often it serves as the proposer in
+the consensus protocol.
+
+The committee scheduler assigns a validator's voting power proportional to its
+entity's [escrow account balance].
+
+<!-- markdownlint-disable line-length -->
+[escrow account balance]: staking.md#escrow
+<!-- markdownlint-enable line-length -->