diff --git a/docs/source-2.0/guides/migrating-idl-1-to-2.rst b/docs/source-2.0/guides/migrating-idl-1-to-2.rst
index 27118ea7860..d642e8d9fff 100644
--- a/docs/source-2.0/guides/migrating-idl-1-to-2.rst
+++ b/docs/source-2.0/guides/migrating-idl-1-to-2.rst
@@ -113,6 +113,38 @@ Needs to be updated to:
     }
 
 
+Convert set shapes to list shapes
+=================================
+
+The set shape was deprecated for IDL 2.0. Each set shape must be replaced by a
+list shape with the :ref:`uniqueItems-trait`.
+
+For example, the following set:
+
+.. code-block:: smithy
+
+    $version "1.0"
+
+    namespace smithy.example
+
+    set StringSet {
+        member: String
+    }
+
+Needs to be updated to:
+
+.. code-block:: smithy
+
+    $version "2"
+
+    namespace smithy.example
+
+    @uniqueItems
+    list StringSet {
+        member: String
+    }
+
+
 Add the default trait to streaming blobs
 ========================================
 
@@ -209,7 +241,7 @@ needed to model an operation. For example, the following model:
 
 can be updated to:
 
-.. code-block::
+.. code-block:: smithy
 
     $version: "2"