diff --git a/docs/data_format_changes/i2688-doc-id-includes-schema.md b/docs/data_format_changes/i2688-doc-id-includes-schema.md
new file mode 100644
index 0000000000..caca83656c
--- /dev/null
+++ b/docs/data_format_changes/i2688-doc-id-includes-schema.md
@@ -0,0 +1,3 @@
+# Incorporate schema root into docID
+
+DocID generation now incorporates schema root, meaning documents created against different schema will no longer clash.  This change also means that all the docIDs and commit CIDs have changed.