diff --git a/schema/README b/schema/README
deleted file mode 100644
index 98e4f9c44effe479ed38c66ba922e7bcc672916f..0000000000000000000000000000000000000000
--- a/schema/README
+++ /dev/null
@@ -1 +0,0 @@
-Generic single-database configuration.
\ No newline at end of file
diff --git a/schema/README.md b/schema/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..c0d37022a5953b12d1f0c91b3414e8a0b8fffeee
--- /dev/null
+++ b/schema/README.md
@@ -0,0 +1,7 @@
+# Workspaces Schema
+
+To upgrade to the newest schema, run:
+
+    env CAPO_PROFILE=$PROFILE alembic upgrade head
+
+where `$PROFILE` is `local` or `nmtest` or `nmprod` or whatever.
\ No newline at end of file