diff --git a/docs/pages/v2.md b/docs/pages/v2.md
index 6e33f617625..7c5cc8eec30 100644
--- a/docs/pages/v2.md
+++ b/docs/pages/v2.md
@@ -579,6 +579,28 @@ module.exports = {
 };
 ```
 
+## `devServerPort`
+
+In your `remix.config.js`, rename `devServerPort` to `dev.port`.
+
+```js bad filename=remix.config.js lines=[3]
+/** @type {import('@remix-run/dev').AppConfig} */
+module.exports = {
+  devServerPort: 8002,
+};
+```
+
+```js filename=remix.config.js good lines=[3-5]
+/** @type {import('@remix-run/dev').AppConfig} */
+module.exports = {
+  future: {
+    v2_dev: {
+      port: 8002,
+    }
+  },
+};
+```
+
 ## `serverBuildDirectory`
 
 In your `remix.config.js`, rename `serverBuildDirectory` to `serverBuildPath` and specify a module path, not a directory.