docs: add warnings on unstable API docs that were deprecated in React… (#10667)

brookslybrand · web-flow · commit 6e570942ee65 · 2025-06-13T15:57:37.000-05:00
diff --git a/docs/guides/file-uploads.md b/docs/guides/file-uploads.md
@@ -2,7 +2,7 @@
 title: File Uploads
 ---
 
-<docs-warning>This doc is a WIP: It was extracted from the API docs for file uploads, so it's a bit out of context. We intend to re-write this as a general guide on file uploads.</docs-warning>
+<docs-warning>The APIs covered in this guide were removed in React Router v7. See <a href="https://reactrouter.com/how-to/file-uploads">the React Router guide to file uploads</a> for the recommended approach.</docs-warning>
 
 Most of the time, you'll probably want to proxy the file to a file host.
 
diff --git a/docs/utils/parse-multipart-form-data.md b/docs/utils/parse-multipart-form-data.md
@@ -4,6 +4,8 @@ title: unstable_parseMultipartFormData
 
 # `unstable_parseMultipartFormData`
 
+<docs-warning>This API is removed in React Router v7. See <a href="https://reactrouter.com/how-to/file-uploads">the React Router guide to file uploads</a> for the recommended alternative API.</docs-warning>
+
 Allows you to handle multipart forms (file uploads) for your app.
 
 It would be useful to understand [the Browser File API][the-browser-file-api] to know how to use this API.
diff --git a/docs/utils/unstable-create-file-upload-handler.md b/docs/utils/unstable-create-file-upload-handler.md
@@ -5,6 +5,8 @@ toc: false
 
 # `unstable_createFileUploadHandler`
 
+<docs-warning>This API is removed in React Router v7. See <a href="https://reactrouter.com/how-to/file-uploads">the React Router guide to file uploads</a> for the recommended alternative API.</docs-warning>
+
 A Node.js upload handler that will write parts with a filename to disk to keep them out of memory, parts without a filename will not be parsed. Should be composed with another upload handler.
 
 **Example:**
diff --git a/docs/utils/unstable-create-memory-upload-handler.md b/docs/utils/unstable-create-memory-upload-handler.md
@@ -5,6 +5,8 @@ toc: false
 
 # `unstable_createMemoryUploadHandler`
 
+<docs-warning>This API is removed in React Router v7. See <a href="https://reactrouter.com/how-to/file-uploads">the React Router guide to file uploads</a> for the recommended alternative API.</docs-warning>
+
 **Example:**
 
 ```tsx
