docs: add --unstable to "Deno 1.x to 2.x Migration Guide" (#816)

denoland · Sep 9, 2024 · 17e92e9 · 17e92e9
1 parent dbcb21b
commit 17e92e9
Showing 1 changed file with 31 additions and 0 deletions.
diff --git a/runtime/manual/advanced/migrate_deprecations.md b/runtime/manual/advanced/migrate_deprecations.md
@@ -101,6 +101,37 @@ Use the `--trace-leaks` CLI flag instead.
 + deno test --trace-leaks
 ```
 
+### ---unstable
+
+Use granular unstable flags (`--unstable-*`) or configuration options instead.
+See
+[Unstable Feature Flags](https://docs.deno.com/runtime/reference/cli/unstable_flags/)
+for reference.
+
+```ts
+// kv.ts
+const kv = await Deno.openKv();
+
+// ...
+```
+
+```diff
+- deno run --unstable kv.ts
++ deno run --unstable-kv kv.ts
+```
+
+Or
+
+```diff
+{
++ "unstable": ["kv"]
+}
+```
+
+See the
+[Deno 1.40 Blog Post](https://deno.com/blog/v1.40#changes-to-how-we-handle-unstable-features)
+for details.
+
 ## Updated symbols
 
 ### Deno.Buffer