Merge branch 'master' into integrate-drawtree

Author: edwardchalstrey1

.github/ISSUE_TEMPLATE/tutorial_request.yml

@@ -3,19 +3,25 @@ description: Submit a request for a new tutorial to be added to the Gambit docum
 title: "[Tutorial]: "
 labels: ["tutorial", "documentation"]
 body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to fill out this tutorial request!
   - type: textarea
     id: describe
     attributes:
       label: Describe the tutorial you want to see.
       description: Go into as much detail as you can regarding the tutorial you would like to see, how long it should be etc.
+      placeholder: "E.g. A step-by-step guide showing how to use PyGambit to compute equilibria for normal and extensive form games..."
       value: "Add a tutorial demonstrating the core components of the PyGambit API."
     validations:
       required: true
   - type: textarea
-    id: describe
+    id: who
     attributes:
       label: Who is the tutorial for?
       description: Explain who the target audience is for this tutorial and what prior knowledge they should have.
+      placeholder: "E.g. Beginners in game theory who know basic Python."
       value: "Newcomers to game theory and the Gambit software who have basic Python programming skills."
     validations:
       required: true
@@ -24,4 +30,6 @@ body:
     attributes:
       label: Add links to papers and software.
       description: Add links to any research papers or other resources the author will need to write this tutorial.
-      value: ""
+      value: "`[Markdown link text](url)`"
+    validations:
+      required: false

tests/test_tutorials.py

@@ -1,10 +1,16 @@
 import contextlib
+import os
 from pathlib import Path
 
 import nbformat
 import pytest
-from nbclient import NotebookClient
-from nbclient.exceptions import CellExecutionError
+
+# Ensure Jupyter uses the new platformdirs paths to avoid DeprecationWarning
+# This will become the default in `jupyter_core` v6
+os.environ.setdefault("JUPYTER_PLATFORM_DIRS", "1")
+
+from nbclient import NotebookClient  # noqa: E402
+from nbclient.exceptions import CellExecutionError  # noqa: E402
 
 
 def _find_tutorial_notebooks():