diff --git a/substrate/wasm-runtime/polkadot/src/runtime/governance.rs b/substrate/wasm-runtime/polkadot/src/runtime/governance.rs
index 43a636f489ccfcd8577da8f4d483facaaa6e3dfe..d7d45fb0d07d67e81eb25b3b4f98fb80cc315d49 100644
--- a/substrate/wasm-runtime/polkadot/src/runtime/governance.rs
+++ b/substrate/wasm-runtime/polkadot/src/runtime/governance.rs
@@ -19,10 +19,11 @@
 //!
 //! For now this is limited to a simple qualified majority vote (whose parameter is retrieved from
 //! storage) between validators. A single vote may be proposed per era, and at most one approval
-//! vote may be cast by each validator. The tally is maintained
-//!
-//!
+//! vote may be cast by each validator. The tally is maintained through a simple tag in storage for
+//! each validator that has approved.
 //!
+//! At the end of the era, all validators approvals are tallied and if there are sufficient to pass
+//! the proposal then it is enacted. All items in storage concerning the proposal are reset.
 
 use runtime_support::Vec;
 use keyedvec::KeyedVec;