diff --git a/pallets/README.md b/pallets/README.md
index 7978650798e24d321dd8b1c4890d2e7257eb13e2..1f0305b5d6fc4a8d3066dc0643a3288433b74bd9 100644
--- a/pallets/README.md
+++ b/pallets/README.md
@@ -17,7 +17,7 @@ These pallets are at the core of Duniter/Äž1 currency
 
 ## Functional pallets
 
-- **`duniter-test-parameters`** TODO
-- **`oneshot-account`** TODO
-- **`provide-randomness`** TODO
-- **`upgrade-origin`** TODO
\ No newline at end of file
+- **`duniter-test-parameters`** Test parameters only used in ÄžDev to allow tweaking parameters more easily.
+- **`oneshot-account`** Oneshot accounts are light accounts only used once for anonimity or convenience use case.
+- **`provide-randomness`** Lets blockchain users ask for a verifiable random number.
+- **`upgrade-origin`** Allows some origins to dispatch a call as root.
\ No newline at end of file
diff --git a/pallets/duniter-account/README.md b/pallets/duniter-account/README.md
index 51b746dd492152e5ca6e1e27eb58e99d9674e725..d9b809d8af43bfdd3598696936445d0b38b5dc71 100644
--- a/pallets/duniter-account/README.md
+++ b/pallets/duniter-account/README.md
@@ -7,3 +7,11 @@ Duniter customizes the `AccountData` of the `Balances` Substrate pallet. In part
 The RandomId field was added with the idea to provide a unique id that can not be controlled by user to serve as a basis for robust identification. The discussion is available on the forum.
 
 https://forum.duniter.org/t/la-solution-pour-des-identicones-securisees-le-random-id/9126
+
+## Account creation fee
+
+DuniterAccount defines a creation fee that is preleved to the account one block after its creation. This fee goes to the treasury.
+
+## Sufficient 
+
+DuniterAccount tweaks the substrate AccountInfo to allow identity accounts to exist without existential deposit. This allows to spare the creation fee.
\ No newline at end of file
diff --git a/pallets/duniter-test-parameters/README.md b/pallets/duniter-test-parameters/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..80a352ff46980635c72de80029cedc324ea6da30
--- /dev/null
+++ b/pallets/duniter-test-parameters/README.md
@@ -0,0 +1,3 @@
+# Duniter test parameters
+
+This pallet allows ÄžDev runtime to tweak parameter values instead of having it runtime constants.
\ No newline at end of file
diff --git a/resources/README.md b/resources/README.md
index aa7aaeb33f7fc08f6b48b207a62570746d6fb957..5bd6a187fa142bcd8c0372c3a39a2ad1795c4a22 100644
--- a/resources/README.md
+++ b/resources/README.md
@@ -1,3 +1,3 @@
 # Resources
 
-TODO
\ No newline at end of file
+Files used for different purpose like tests.
\ No newline at end of file
diff --git a/scripts/README.md b/scripts/README.md
index 2d79b0c225b6b27d05918ccac310534fcf96a3e9..95a516bbdfe62ad34c6d6cf22f743e79e8feffb3 100644
--- a/scripts/README.md
+++ b/scripts/README.md
@@ -1,3 +1,3 @@
 # Scripts
 
-TODO
\ No newline at end of file
+Scripts not moved to xtasks because they only depend on Docker and not Rust.
\ No newline at end of file