Merge remote-tracking branch 'upstream/main'

Author: ashwinvis

content/conf.py

@@ -44,7 +44,12 @@
 # jupyter_execute_notebooks = "off"
 # jupyter_execute_notebooks = "auto"   # *only* execute if at least one output is missing.
 # jupyter_execute_notebooks = "force"
-jupyter_execute_notebooks = "cache"
+nb_execution_mode = "cache"
+
+# https://myst-parser.readthedocs.io/en/latest/syntax/optional.html
+myst_enable_extensions = [
+    "colon_fence",
+]
 
 # Add any paths that contain templates here, relative to this directory.
 # templates_path = ['_templates']

content/guide.md

@@ -0,0 +1,17 @@
+# Instructor's guide
+
+## Why we teach this lesson
+
+## Intended learning outcomes
+
+## Timing
+
+## Preparing exercises
+
+e.g. what to do the day before to set up common repositories.
+
+## Other practical aspects
+
+## Interesting questions you might get
+
+## Typical pitfalls

content/guide.rst renamed to content/guide.rst-if-wanted

@@ -0,0 +1,37 @@
+# LESSON NAME
+
+Intro
+
+:::{prereq}
+prerequisites
+:::
+
+```{csv-table}
+:delim: ;
+:widths: auto
+
+20 min ; {doc}`filename`
+```
+
+```{toctree}
+:caption: The lesson
+:maxdepth: 1
+```
+
+```{toctree}
+:caption: Reference
+:maxdepth: 1
+
+quick-reference
+guide
+```
+
+(learner-personas)=
+
+## Who is the course for?
+
+## About the course
+
+## See also
+
+## Credits

content/index.md

@@ -0,0 +1 @@
+# Quick Reference

content/index.rst renamed to content/index.rst-if-wanted

@@ -1,5 +1,5 @@
 Sphinx
-sphinx_rtd_theme
+sphinx_rtd_theme>=2.0
 sphinx_rtd_theme_ext_color_contrast
 myst_nb
 sphinx-lesson