From 4f213c6182048a1762d29e25e523d5381be67305 Mon Sep 17 00:00:00 2001
From: iskay <ikay@lakeheadu.ca>
Date: Tue, 26 Mar 2024 16:11:34 -0400
Subject: [PATCH 1/2] merge branch TuanTQ15/improve/governance

---
 .../users/public-goods-stewards/electing.mdx  | 19 +++++++++++++++++++
 .../users/public-goods-stewards/voting.mdx    |  2 ++
 2 files changed, 21 insertions(+)

diff --git a/packages/docs/pages/users/public-goods-stewards/electing.mdx b/packages/docs/pages/users/public-goods-stewards/electing.mdx
index 6af83969..8c8a2b27 100644
--- a/packages/docs/pages/users/public-goods-stewards/electing.mdx
+++ b/packages/docs/pages/users/public-goods-stewards/electing.mdx
@@ -90,3 +90,22 @@ namadac resign-steward --steward my-steward-address
 ```
 
 Read more about the other methods of losing stewardship in the [specs](https://specs.namada.net/modules/goverance/public-goods-funding/becoming-a-steward#losing-stewardship-status).
+
+## Update steward commissions
+
+The `commissions.json` file contains the information about the reward distribution. It is a JSON file with the following structure:
+
+```json
+{
+    "reward_distribution": {
+        "tnam...": "1"
+    }
+}
+```
+
+Update steward commissions can be done at any point. 
+Through the CLI it can be done with the command:
+
+```shell copy
+namadac  update-steward-rewards --steward my-steward-address --data-path <path/to/commissions.json>
+```
\ No newline at end of file
diff --git a/packages/docs/pages/users/public-goods-stewards/voting.mdx b/packages/docs/pages/users/public-goods-stewards/voting.mdx
index 2c718915..44b54582 100644
--- a/packages/docs/pages/users/public-goods-stewards/voting.mdx
+++ b/packages/docs/pages/users/public-goods-stewards/voting.mdx
@@ -9,6 +9,7 @@ The CLI command for voting for a steward is:
 ```shell copy
 namada client vote-proposal \
     --proposal-id <proposal-id-of-steward-proposal> \
+    --address your-established-account \
     --vote yay \
     --signing-keys <your-alias>
 ```
@@ -22,6 +23,7 @@ Similarly, the command for voting for PGF proposals is:
 ```shell copy
 namada client vote-proposal \
     --proposal-id <proposal-id-of-steward-proposal> \
+    --address your-established-account \
     --vote yay \
     --signing-keys <your-alias>
 ```
\ No newline at end of file

From d72d6b052b08b91d54cdfc132fd0307d7f063fd6 Mon Sep 17 00:00:00 2001
From: iskay <ikay@lakeheadu.ca>
Date: Tue, 26 Mar 2024 16:12:31 -0400
Subject: [PATCH 2/2] merge branch TuanTQ15/improve/pos

---
 .../operators/validators/proof-of-stake.mdx   | 50 +++++++++++++++++++
 1 file changed, 50 insertions(+)

diff --git a/packages/docs/pages/operators/validators/proof-of-stake.mdx b/packages/docs/pages/operators/validators/proof-of-stake.mdx
index cd48cbee..85ea2e09 100644
--- a/packages/docs/pages/operators/validators/proof-of-stake.mdx
+++ b/packages/docs/pages/operators/validators/proof-of-stake.mdx
@@ -82,4 +82,54 @@ After updating the consensus key, validators can find out their new validator ad
 namadaw find --alias <new-consensus-key>
 ```
 
+## Commission
 
+To query a validator's commission rate, the following command can be run:
+
+```shell copy
+namadac commission-rate --validator <validator-address>
+```
+
+To change a validator's commission rate, the following command can be run:
+
+```shell copy
+namadac change-commission-rate \
+  --validator <validator-address> \
+  --commission-rate <new-commission-rate>
+```
+
+## Change Metadata
+
+To query a validator's metadata, the following command can be run:
+
+```shell copy
+namadac validator-metadata --validator <validator-address>
+```
+
+To change a validator's metadata, the following command can be run:
+
+```shell copy
+namadac change-metadata \
+  --validator <validator-address> \
+  --email <email> \
+  --avatar <avatar-url>\
+  --description <description> \
+  --website <website-url> \
+  --discord-handle <discord-handle>
+```
+
+## Deactivate
+
+To deactivate a validator, the following command can be run:
+
+```shell copy
+namadac deactivate-validator --validator <validator-address>
+```
+
+## Reactivate
+
+To reactivate a validator, the following command can be run:
+
+```shell copy
+namadac reactivate-validator --validator <validator-address>
+```
\ No newline at end of file