MAINT,DOC: Update dependencies and warnings to ignore when building docs

Author: melissawm

dev.py

@@ -987,6 +987,10 @@ def task_meta(cls, list_targets, parallel, args, **kwargs):
         make_params = [f'PYTHON="{sys.executable}"']
         if parallel:
             make_params.append(f'SPHINXOPTS="-j{parallel}"')
+        # Environment variables needed for notebooks
+        
+        make_params.append('SQLALCHEMY_SILENCE_UBER_WARNING=1')
+        make_params.append('JUPYTER_PLATFORM_DIRS=1')
 
         return {
             'actions': [

doc/source/conf.py

@@ -156,6 +156,12 @@
 warnings.filterwarnings(  # matplotlib<->pyparsing issue
     'ignore', message="Exception creating Regex for oneOf.*",
     category=SyntaxWarning)
+warnings.filterwarnings(  # docutils warning when using notebooks
+    'ignore', message="The frontend.OptionParser class will be replaced",
+    category=DeprecationWarning)
+warnings.filterwarnings(
+    'ignore', message="The frontend.Option class will be removed in Docutils 0.21 or later.",
+    category=DeprecationWarning)
 # warnings in examples (mostly) that we allow
 # TODO: eventually these should be eliminated!
 for key in (

environment.yml

@@ -38,7 +38,6 @@ dependencies:
   - matplotlib
   - pydata-sphinx-theme==0.9.0
   - sphinx-design
-  - docutils<0.18.1
   - jupytext
   - myst-nb
   # For linting