From 38dab4b641824b4d652209380802ae125b645d5b Mon Sep 17 00:00:00 2001
From: Henry Schreiner <HenrySchreinerIII@gmail.com>
Date: Fri, 6 Jun 2025 09:57:58 -0400
Subject: [PATCH] docs: warning about pyodide-version (#2450)

---
 docs/options.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/docs/options.md b/docs/options.md
index bf239856..c91b0b8e 100644
--- a/docs/options.md
+++ b/docs/options.md
@@ -1253,6 +1253,12 @@ The available Pyodide versions are determined by the version of `pyodide-build`
 !!! tip
     You can set the version of `pyodide-build` using the [`dependency-versions`](#dependency-versions) option.
 
+!!! warning
+    This option is considered experimental, and might be converted to a more general mechanism in a future minor cibuildwheel release.
+
+!!! warning
+    Make sure to scope it to one specific pyodide identifier with overrides if using the `pyodide-prerelease` enable.
+
 #### Examples
 
 !!! tab examples "pyproject.toml"