diff --git a/gradually-update/README.md b/gradually-update/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..dfa26e4c038bc9f8ff372cbca5fa5abb314bac69
--- /dev/null
+++ b/gradually-update/README.md
@@ -0,0 +1,5 @@
+# Gradually-update module
+
+### Overview
+
+Gradually-update module provides a way to adjust numeric parameter such as stability fee or liquidation gradually. The update code should be able to handle different numeric types such as `u32`, `u128`, `Permill`, `FixedU128`. All the values are assumed to be little-endian and unsigned.
diff --git a/schedule-update/README.md b/schedule-update/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..638ccbba5c47358a20b97af560a61c72715b8733
--- /dev/null
+++ b/schedule-update/README.md
@@ -0,0 +1,5 @@
+# Schedule-update module
+
+### Overview
+
+Schedule-update module provides a way to allow an update to be dispatched at later block. This is Useful for council to dispatch a delayed update so other have time to review and learn the change. Council also have chance to cancel the update if any issues were found.