update docs to include interactive catalog demo - should also function as a test - doc failure <=> broken

Author: charles-turner-1

ci/environment-docs.yml

@@ -10,6 +10,7 @@ dependencies:
   - fsspec >=2024.12
   - gcsfs >=2024.12
   - intake >=2.0
+  - itables
   - jupyterlab
   - matplotlib
   - myst-nb

docs/source/how-to/use-catalogs-with-assets-containing-multiple-variables.md

@@ -63,13 +63,21 @@ cat.esmcat.has_multiple_variable_assets
 
 ## Search for datasets
 
-The search functionatilty works in the same way:
+The search functionality works in the same way:
 
 ```{code-cell} ipython3
 cat_subset =cat.search(variable=["O2", "SiO3"])
 cat_subset.df
 ```
 
+### Interactively search the catalog
+
+We can also use the `interactive` attribute of a catalog to interactively search the catalog. This will not save any searches, but allows you to explore the catalog in a quick and intuitive way.
+
+```{code-cell} ipython3
+cat.interactive
+```
+
 ## Load assets into xarray datasets
 
 When loading the data files into xarray datasets, `intake-esm` will load only **data variables** that were requested. For example, if a data file contains ten data variables and the user requests for two variables, intake-esm will load the two requested variables plus necessary coordinates information.