docs: add simple docs

docs/execute-notebooks.md

@@ -65,6 +65,24 @@ name = input("What is your name?")
 
 Additional [cell tags](#tbl:notebook-cell-tags) to hide, remove, or raise exceptions are also possible.
 
+## Skip entire notebooks
+
+You may wish to disable execution for certain notebooks. This can be done by setting the top-level `skip_execution` frontmatter option to `true`, e.g.
+
+````markdown
+---
+kernelspec:
+  name: python3
+  display_name: Python 3
+
+skip_execution: true
+---
+
+```{code-cell}
+print("This will never be executed!")
+```
+````
+
 ## Cache execution outputs
 
 When MyST executes your notebook, it will store the outputs in a cache in a folder called `execute/` in your MyST build folder.

docs/frontmatter.md

@@ -229,6 +229,9 @@ The following table lists the available frontmatter fields, a brief description
 * - `kernelspec`
   - configuration for the kernel (see [](#kernel-specification))
   - page only
+* - `skip_execution`
+  - opt-out of execution for a particular document (see [](./execute-notebooks))
+  - page only
 ```
 
 +++
@@ -850,4 +853,4 @@ These fields provide a more complete superset of publication metadata than the [
 
 > Old-timey bibliographic info for this work. This is mostly useful only in citation/reference contexts. These are all strings because sometimes you'll get fun values like "Spring" and "Inside cover."
 
-If MyST frontmatter includes an OpenAlex `biblio` object, it will be coerced to valid publication metadata.
+If MyST frontmatter includes an OpenAlex `biblio` object, it will be coerced to valid publication metadata.