Make it clear that you're passing the hash of your new, proposed kern…

…el (#115)

* Make it clear that you're passing the hash of your new, proposed kernel

* Make it clear what the examples are

docs/governance/how-do-i-participate-in-governance.md

@@ -67,7 +67,7 @@ You can also subscribe to the `voting_finished` event to be notified when the Pr
 
 ### Proposing and upvoting upgrades
 
-During a Proposal period, bakers can propose kernel or security updates by calling the `new_proposal` entrypoint of the appropriate governance contract, as in this example:
+During a Proposal period, bakers can propose kernel or security updates by calling the `new_proposal` entrypoint of the appropriate governance contract and passing the hash of their proposed kernel, as in this example, which uses `0x00927d...` as an example kernel hash:
 
 ```bash
 octez-client transfer 0 from my_wallet to KT1H5pCmFuhAwRExzNNrPQFKpunJx1yEVa6J \
@@ -79,12 +79,13 @@ The command takes these parameters:
 
 - The address or Octez client alias of your baker account
 - The address of the Etherlink kernel or security governance contract
-- The hash of the kernel upgrade
+- The hash of the upgraded kernel, which the proposer must generate from the code of the new kernel
 
 The proposer must make the code of the new kernel available for people to evaluate.
 Proposers can make it easier for bakers to upgrade to the new kernel by providing the preimages for the kernel online so nodes can update from them directly.
 
-To upvote a proposed kernel or security update during a Proposal period, call the `upvote_proposal` entrypoint with the same parameters:
+To upvote a proposed kernel or security update during a Proposal period, call the `upvote_proposal` entrypoint with the same parameters.
+This example again uses `0x00927d...` as an example kernel hash:
 
 ```bash
 octez-client transfer 0 from my_wallet to KT1H5pCmFuhAwRExzNNrPQFKpunJx1yEVa6J \
@@ -109,6 +110,8 @@ The command takes these parameters:
 - The address of the Etherlink kernel or security governance contract
 - `"yea"`, `"nay"`, or `"pass"`, including the double quotes
 
+The command does not need the hash of the kernel because only one kernel can be in the Promotion period at a time, so the options are to vote for or against that kernel or to abstain by voting "pass."
+
 ### Triggering upgrades
 
 After a proposal wins a vote, any user can trigger the kernel or security upgrade by calling the governance contract's `trigger_kernel_upgrade` entrypoint:
@@ -162,7 +165,7 @@ The command takes these parameters:
 - The address or Octez client alias of your baker account
 - The address of the Sequencer Committee governance contract
 - The public key (not the public key hash or account address) of the account to propose, including the double quotes
-- The Etherlink address of the account to propose
+- The Etherlink address of the account to propose; the examples below use `0xb7a970` as the account address
 
 For example: