diff --git a/docs/user-guide/configuration.md b/docs/user-guide/configuration.md
index ea69be25..f7c0260f 100644
--- a/docs/user-guide/configuration.md
+++ b/docs/user-guide/configuration.md
@@ -57,7 +57,7 @@ reference it from the tag used to specify the Python code:
If you use JSON, you can make it the value of the `config` attribute:
```HTML title="JSON as the value of the config attribute."
-
+
```
For historical and convenience reasons we still support the inline
@@ -81,6 +81,15 @@ _single_ `` or `` tag in your HTML document:
with [`py-game`](../pygame-ce) or [`py-editor`](../editor). For these use the config
attribute method.
+!!! warning
+
+ Starting from PyScript 2025.10.1 the config guards against incompatible or not
+ available packages related to the current Pyodide version.
+
+ There is an ongoing effort to make chosing packages in Pyodide way more helpful
+ than it has ever been but right now be aware if a non existent package for a
+ specific Pyodide version cannot be found an error will be thrown.
+
## Options
There are five core options ([`interpreter`](#interpreter), [`files`](#files),
@@ -105,12 +114,12 @@ a custom version of the interpreter.
The following two examples are equivalent:
```TOML title="Specify the interpreter version in TOML."
-interpreter = "0.23.4"
+interpreter = "0.29.0"
```
```JSON title="Specify the interpreter version in JSON."
{
- "interpreter": "0.23.4"
+ "interpreter": "0.29.0"
}
```
@@ -119,7 +128,7 @@ version of Pyodide as specified in the previous examples:
```JSON title="Specify the interpreter via a fully qualified URL."
{
- "interpreter": "https://cdn.jsdelivr.net/pyodide/v0.23.4/full/pyodide.mjs"
+ "interpreter": "https://cdn.jsdelivr.net/pyodide/v0.29.0/full/pyodide.mjs"
}
```