Finish sync with template

dev.ps1

@@ -41,7 +41,7 @@ function Install-Uv {
     Param([switch]$Update)
     $Env:PATH = "$HOME/.cargo/bin$([System.IO.Path]::PathSeparator)$Env:PATH"
     if ((Get-Command 'uv' -ErrorAction 'Ignore') -and $Update) {
-        try { uv self update }
+        try { return uv self update }
         catch [System.Management.Automation.NativeCommandExitException] {}
     }
     if ($IsWindows) {
@@ -221,7 +221,6 @@ function Sync-Template {
     if (!(Get-Command 'uv' -ErrorAction 'Ignore')) { Install-Uv -Update }
     $Copier = "copier@$(Get-Content '.copier-version')"
     $Ref = $Stay ? (Get-Content '.copier-answers.yml' | Find-Pattern '^_commit:\s.+-(.+)$') : $Ref
-    if (!$Ref) {$Ref = 'HEAD'}
     if ($Recopy) {
         if ($Prompt) { return uvx $Copier recopy $Defaults --vcs-ref=$Ref }
         return uvx $Copier recopy --overwrite --defaults

docs/conf.py

@@ -59,7 +59,6 @@
 
 def setup(app: Sphinx):
     """Add functions to Sphinx setup."""
-    init_nb_env()
     app.connect("html-page-context", add_version_to_css)
 
 

packages/_dev/dev/docs/__init__.py

@@ -1 +1,27 @@
 """Documentation tools."""
+
+import os
+from pathlib import Path
+
+DOCS = Path("docs")
+"""Docs directory."""
+PYPROJECT = Path("pyproject.toml")
+"""Path to `pyproject.toml`."""
+CHECKS = [DOCS, PYPROJECT]
+"""Checks for the root directory."""
+
+
+def chdir_docs() -> Path:
+    """Ensure we are in the `docs` directory and return the root directory."""
+    root = get_root()
+    os.chdir(root / "docs")
+    return root
+
+
+def get_root() -> Path:
+    """Get the project root directory."""
+    path = Path().cwd()
+    while not all((path / check).exists() for check in CHECKS):
+        if path == (path := path.parent):
+            raise RuntimeError("Either documentation or `pyproject.toml` is missing.")
+    return path