diff --git a/README.md b/README.md
index 52fb473fd..5aa4d2251 100644
--- a/README.md
+++ b/README.md
@@ -31,8 +31,31 @@ A library containing Swift types that encode to- and decode from [OpenAPI](https
 
 ## Usage
 
+### Migration
+#### 1.x to 2.x
 If you are migrating from OpenAPIKit 1.x to OpenAPIKit 2.x, check out the [migration guide](./documentation/v2_migration_guide.md).
 
+#### 2.x to 3.0.0
+There is not yet a migration guide for upgrading from OpenAPIKit 2.x to OpenAPIKit 3.0.0. You will need to start being explicit about which of the two new modules you want to use in your project: `OpenAPIKit` (now supports OpenAPI spec v3.1) and/or `OpenAPIKit30` (continues to support OpenAPI spec v3.0 like the previous versions of OpenAPIKit did).
+
+In package manifests, dependencies will be one of:
+```
+// v3.0 of spec:
+dependencies: [.product(name: "OpenAPIKit30", package: "OpenAPIKit")]
+
+// v3.1 of spec:
+dependencies: [.product(name: "OpenAPIKit", package: "OpenAPIKit")]
+```
+
+Your imports need to be specific as well:
+```swift
+// v3.0 of spec:
+import OpenAPIKit30
+
+// v3.1 of spec:
+import OpenAPIKit
+```
+
 ### Decoding OpenAPI Documents
 
 You can decode a JSON OpenAPI document (i.e. using the `JSONDecoder` from **Foundation** library) or a YAML OpenAPI document (i.e. using the `YAMLDecoder` from the [**Yams**](https://github.com/jpsim/Yams) library) with the following code: