diff --git a/db/README.md b/db/README.md
new file mode 100644
index 00000000..83195e1c
--- /dev/null
+++ b/db/README.md
@@ -0,0 +1,7 @@
+# Database
+
+This directory contains files related to the MongoDB database managed by the Runtime.
+
+It has the following subdirectories:
+
+- `./migrations`: files related to migrating the MongoDB database
diff --git a/db/migrations/README.md b/db/migrations/README.md
new file mode 100644
index 00000000..5cf247a3
--- /dev/null
+++ b/db/migrations/README.md
@@ -0,0 +1,3 @@
+# Migrations
+
+This directory contains files related to migrating the MongoDB database between schemas.