minor tweaks from getting started

python/README.md

@@ -44,7 +44,7 @@ nox
 * Generate reference docs
 
   ```shell
-  nox -s gen-docs
+  nox -s docs-gen
   ```
 
   You should re-run this after making any updates to the `pysrc` docstrings.
@@ -71,4 +71,3 @@ nox
   ```
 
   This is primarily used in CI.
-

python/noxfile.py

@@ -140,6 +140,10 @@ def docs_gen(session: nox.Session) -> None:
 @nox.session(python=python_versions[0])
 def docs(session: nox.Session) -> None:
     """Build and serve the documentation with live reloading on file changes."""
+    if not shutil.which("quarto"):
+        session.error("Unable to execute `quarto`. Is it installed and in your path?\n"
+                      "See https://quarto.org/docs/get-started/")
+
     install(session, groups=["docs"])
 
     with session.chdir("docs"):
@@ -149,6 +153,10 @@ def docs(session: nox.Session) -> None:
 @nox.session(name="docs-build", python=python_versions[0])
 def docs_build(session: nox.Session) -> None:
     """Build the docs."""
+    if not shutil.which("quarto"):
+        session.error("Unable to execute `quarto`. Is it installed and in your path?\n"
+                      "See https://quarto.org/docs/get-started/")
+
     install(session, groups=["docs"])
 
     with session.chdir("docs"):