diff --git a/README.md b/README.md
index 5c6a56882e401bb489d448bc71cd11c73aacfbab..60ecc082d6a438761314c345fcf54a86e1408b47 100644
--- a/README.md
+++ b/README.md
@@ -20,7 +20,7 @@
 - [docs](./docs/)
   - [api](./docs/api/)
     - [manual](./docs/api/manual.md)
-    - [runtime-calls](./docs/api/runtime-calls.md)
+    - [runtime-calls](./docs/api/runtime-calls.md) the calls you can submit through the RPC API
   - [dev](./docs/dev/)
     - [git-conventions](./docs/dev/git-conventions.md)
     - [launch-a-live-network](./docs/dev/launch-a-live-network.md)
diff --git a/docs/api/manual.md b/docs/api/manual.md
index 6dd762be5483b8dc0dce5a0a9d085a468963a76c..86700e0e1e83702b08620149aa2d4fa599f6dd37 100644
--- a/docs/api/manual.md
+++ b/docs/api/manual.md
@@ -1,6 +1,6 @@
 # Manual for wallet developers
 
-This functionnal documentation presents how wallets can interact with the blockchain.
+This functional documentation presents how wallets can interact with the blockchain.
 It is intended to complete the [runtime calls documentation](./runtime-calls.md) in a runtime-specific way to fit the real needs of wallet developers.
 
 Only ÄžDev is covered for now.
@@ -23,9 +23,9 @@ Only use `identity` pallet. The `membership` calls are disabled.
 
 ## Revoke an identity
 
-Revoking an identity makes it lose its membership, hence UD creation and governance rights. Orher data such as balance will remain.
+Revoking an identity makes it lose its membership, hence UD creation and governance rights. Other data such as balance will remain.
 
-This feature is useful in case the user has lost their private key.
+This feature is useful in case the user has lost their private key since the revocation document can be made in advance.
 
 ### Generate the revocation payload
 
diff --git a/docs/dev/launch-a-live-network.md b/docs/dev/launch-a-live-network.md
index 7b3a1f7b41041f300a821ba663d79bcb6661eb3e..12b21b365df7172810aa408b84f3426c08709e68 100644
--- a/docs/dev/launch-a-live-network.md
+++ b/docs/dev/launch-a-live-network.md
@@ -2,7 +2,7 @@
 
 ## 1. Choose the currency type
 
-Ensure that the currency type you want have the requirements.
+Ensure that the currency type you want has the requirements.
 
 For now, only `gdev` is supported.
 
diff --git a/docs/dev/verify-runtime-code.md b/docs/dev/verify-runtime-code.md
index d99b7f08416e529e958a0e6abc9d56aacc0c4533..6903dcba695103ceab7291e516e116b7ce835e21 100644
--- a/docs/dev/verify-runtime-code.md
+++ b/docs/dev/verify-runtime-code.md
@@ -1,5 +1,7 @@
 # Compile the runtime with srtool
 
+When voting for a runtime upgrade, you should check that the proposed sha256sum actually corresponds to the published code you reviewed. Otherwise, a malicious runtime upgrade could be advertised as a legitimate one.
+
 ```docker
 docker run \
   -i \
diff --git a/docs/dev/weights-benchmarking.md b/docs/dev/weights-benchmarking.md
index 6f7f3358edfd450701334d106495822e0676bacd..8d5b699d95fe8e8a4fae0521e7bff21abac5fc23 100644
--- a/docs/dev/weights-benchmarking.md
+++ b/docs/dev/weights-benchmarking.md
@@ -6,22 +6,22 @@ complete real example.
 `cargo test -p <pallet> --features runtime-benchmarks`
 3. If the benchmark tests compiles and pass, compile the binary with benchmarks on your local
 machine: `cargo build --release --features runtime-benchmarks`
-4. Run the benchmarks on your local machine (to test if it work mith a real runtime). The command
+4. Run the benchmarks on your local machine (to test if it work with a real runtime). The command
 is: `duniter benchmark pallet --chain=CURRENCY-dev --steps=50 --repeat=20 --pallet=pallet_universal_dividend --extrinsic=* --execution=wasm --wasm-execution=compiled --heap-pages=4096 --header=./file_header.txt --output=.`
-5. If it work, use the generated file content to create or update the `WeightInfo` trait and the `()` dummy implementation. Then use the `WeightInfo` tarit in the real code of the pallet. See 79e0fd4bf3b0579279fc957da5e2fdfc6d8a17fa for a
+5. If it worked, use the generated file content to create or update the `WeightInfo` trait and the `()` dummy implementation. Then use the `WeightInfo` tarit in the real code of the pallet. See 79e0fd4bf3b0579279fc957da5e2fdfc6d8a17fa for a
 complete real example.
 6. Redo steps `3.` and `4.` on the reference machine.
 7. Put the generated file on `runtime/common/src/weights` and use it in the runtimes configuration.
 See cee7c3b2763ba402e807f126534d9cd39a8bd025 for a complete real example.
 
-Note 1: You Must replace `CURRENCY` by the currency type, or for ÄžDev use directly `--chain=dev`.
+Note 1: You *must* replace `CURRENCY` by the currency type, or for ÄžDev use directly `--chain=dev`.
 
-Note2. If the reference machine not support wasmtime, you should replace `--wasm-execution=compiled`
+Note 2: If the reference machine does not support wasmtime, you should replace `--wasm-execution=compiled`
 by `--wasm-execution=interpreted-i-know-what-i-do`.
 
-## What the reference machine is?
+## What is the reference machine?
 
-For now (06/2022), it's a `Raspberry Pi 4 Model B - 4GB` with an SSD connected via USB3.
+For now (09/2022), it's a `Raspberry Pi 4 Model B - 4GB` with an SSD connected via USB3.
 
 To cross-compile the benchmarks binary for armv7:
 
diff --git a/end2end-tests/README.md b/end2end-tests/README.md
index 6bea5535161d2e486fc8cae70415ae783728139b..602883bfc79fc5f47b90ba0cfef2736c85a4a74d 100644
--- a/end2end-tests/README.md
+++ b/end2end-tests/README.md
@@ -1,6 +1,6 @@
 # Duniter-v2s end2end tests
 
-## Cucumber functionnal tests
+## Cucumber functional tests
 
 We use [cucumber] to be able to describe test scenarios in human language.