docs: a few more bits of polish

Signed-off-by: Henry Schreiner <henryfs@princeton.edu>
Assisted-by: CopilotCLI:GPT-5.4-mini

Author: henryiii

docs/assets/js/repo-review-widget.mjs

@@ -19,7 +19,8 @@ export async function render({ model, el }) {
   // Determine the correct path to the app
   // The widget will be in /build/ and the app is in /assets/js/
   const baseUrl = new URL(import.meta.url);
-  const appUrl = new URL("../../assets/js/repo-review-app.min.js", baseUrl).href;
+  const appUrl = new URL("../../assets/js/repo-review-app.min.js", baseUrl)
+    .href;
 
   // Load the app via dynamic import
   try {
@@ -38,7 +39,7 @@ export async function render({ model, el }) {
       });
     } else {
       console.warn(
-        "repo-review-app.min.js does not export mountApp, attempting alternative load"
+        "repo-review-app.min.js does not export mountApp, attempting alternative load",
       );
       // Try loading as a script tag instead
       loadAppAsScript(appUrl);

docs/myst.yml

@@ -57,3 +57,4 @@ site:
     logo: assets/images/logo.svg
     logo_text: Scientific Python Development Guide
     style: assets/css/site.css
+    hide_footer_links: false

docs/pages/guides/gha_pure.md

@@ -185,7 +185,7 @@ delete your user-scoped token and generate a new project-scoped token.
 :::
 ::::
 
-:::{dropdown} Complete recipe
+:::::{dropdown} Complete recipe
 This can be used on almost any package with a standard
 `.github/workflows/cd.yml` recipe. This works because `pyproject.toml` describes
 exactly how to build your package, hence all packages build exactly via the same
@@ -291,7 +291,7 @@ You'll need to go to PyPI, generate a token for your user, and put it into
 delete your user-scoped token and generate a new project-scoped token.
 :::
 ::::
-:::
+:::::
 
 [pep 517]: https://www.python.org/dev/peps/pep-0517/
 [pep 518]: https://www.python.org/dev/peps/pep-0518/

docs/pages/guides/style.md

@@ -140,8 +140,8 @@ There are a _few_ options, mostly to enable/disable certain files, remove string
 normalization, and to change the line length, and those go in your
 `pyproject.toml` file.
 
-::::{tab-set}
-:::{tab-item} Ruff-format
+:::::{tab-set}
+::::{tab-item} Ruff-format
 Ruff, the powerful Rust-based linter, has a formatter that is designed with the
 help of some of the Black authors to look 99.9% like Black, but run 30x faster.
 Here is the snippet to add the formatter to your `.pre-commit-config.yml`
@@ -171,8 +171,8 @@ recommended as well.
 ```
 
 :::
-:::
-:::{tab-item} Black
+::::
+::::{tab-item} Black
 Here is the snippet to add Black to your `.pre-commit-config.yml`:
 
 ```yaml
@@ -194,9 +194,9 @@ Here is the snippet to add Black to your `.pre-commit-config.yml`:
     :target: https://github.com/psf/black
 ```
 
-:::
 :::
 ::::
+:::::
 
 In _very_ specific situations, like when making a 2D array, you may want to
 retain special formatting. After carefully deciding that it is a special use
@@ -435,7 +435,7 @@ release.
 
 :::
 
-:::{dropdown} Separate tools that Ruff replaces
+::::{dropdown} Separate tools that Ruff replaces
 
 #### PyCln
 
@@ -600,7 +600,7 @@ args: ["-a", "from __future__ import annotations"]
 Also make sure isort comes before pyupgrade. Now when you run pre-commit, it
 will clean up your annotations to 3.7+ style, too!
 :::
-:::
+::::
 
 ### Type checking
 
@@ -681,7 +681,7 @@ errors in your typing.
 
 If you use setuptools, these checks are useful:
 
-:::{dropdown} Setuptools-only checks
+::::{dropdown} Setuptools-only checks
 
 #### Check-Manifest (setuptools only)
 
@@ -742,7 +742,7 @@ important parts (like Python classifiers) are in sync. This tool,
 ```
 
 Make sure you list the highest version of Python you are testing with here.
-:::
+::::
 
 ### Spelling
 

docs/pages/principles/testing.md

@@ -16,7 +16,7 @@ the Features that your project provides. Then we will cover
 [Project Level Integration tests](#project-level-integration-tests), which test
 that the various parts of your package work together, and work with the other
 packages it depends on. Finally we will cover the venrable
-[Unit Test](#unit-tests), which test the correctness of your code from a
+{ref}`Unit Test <unit-tests>`, which test the correctness of your code from a
 perspective internal to your codebase, tests individual units in isolation, and
 are optimized to run quickly and often.
 
@@ -101,11 +101,11 @@ Tests should be divided up into different Suites, which can be run independently
 of one another.
 
 Tests which "Fail Fast" save both developer and compute time. Some tests are by
-necessity very slow. [Unit Tests](#unit-tests) should run extremely quickly in
-just a few seconds at most, while [end-to-end](#end-to-end-tests) require time
-to set up and may depend on slow and unreliable external services. By organizing
-tests into suites based on execution time, you can run fast suites first and
-stop if an error is encountered before running slower suites.
+necessity very slow. {ref}`Unit Tests <unit-tests>` should run extremely quickly
+in just a few seconds at most, while [end-to-end](#end-to-end-tests) require
+time to set up and may depend on slow and unreliable external services. By
+organizing tests into suites based on execution time, you can run fast suites
+first and stop if an error is encountered before running slower suites.
 
 #### Advantages of Test Suites
 

helpers/cog_helpers.py

@@ -84,6 +84,9 @@ def __contains__(self, dotted_name: str, /) -> bool:
 
 @contextlib.contextmanager
 def code_fence(lang: str, /, *, width: int = 3) -> Generator[None, None, None]:
+    # Fixed in https://github.com/jupyter-book/myst-theme/pull/883
+    if lang == "toml":
+        lang = "ini"
     tics = "`" * width
     print("<!-- rumdl-disable MD013 -->")  # noqa: T201
     print(f"{tics}{lang}")  # noqa: T201

package.json

@@ -3,8 +3,8 @@
   "private": true,
   "type": "module",
   "scripts": {
-    "build": "cd docs && myst build --html && cd .. && bash helpers/copy-assets.sh",
-    "serve": "cd docs && myst start",
+    "build": "cd docs && NODE_OPTIONS='--localstorage-file=_build/.node-localstorage --no-deprecation' myst build --html && cd .. && bash helpers/copy-assets.sh",
+    "serve": "cd docs && NODE_OPTIONS='--localstorage-file=_build/.node-localstorage --no-deprecation' myst start",
     "clean": "rm -rf docs/_build"
   },
   "dependencies": {