refactor: rename docs-build.yml to build-docs.yml to better follow the existing verb-type naming pattern that the other github actions follow

Author: 56kyle

tests/constants.py

@@ -28,7 +28,7 @@
     "format-python",
     *TYPE_CHECK_NOX_SESSIONS,
     *TESTS_NOX_SESSIONS,
-    "docs-build",
+    "build-docs",
     "build-python",
     "build-container",
     "tox",

…_name}}/.github/workflows/docs-build.yml …_name}}/.github/workflows/build-docs.yml{{cookiecutter.project_name}}/.github/workflows/docs-build.yml renamed to {{cookiecutter.project_name}}/.github/workflows/build-docs.yml {{cookiecutter.project_name}}/.github/workflows/docs-build.yml renamed to {{cookiecutter.project_name}}/.github/workflows/build-docs.yml

@@ -1,19 +1,18 @@
-# .github/workflows/docs-build.yml
+# .github/workflows/build-docs.yml
 # See https://docs.github.com/en/actions/reference/workflow-syntax-for-github-actions
 
 name: Build Documentation
 
 on:
   pull_request:
     paths:
-      - "docs/**" # Documentation source files
-      - "src/**/*.py" # Code changes might impact API docs
+      - "docs/**"
+      - "src/**/*.py"
       - "noxfile.py"
       - "pyproject.toml"
-      - ".github/workflows/docs-build.yml"
-      # Include relevant config files that affect docs build
-      - ".ruff.toml" # Affects docstrings via linting
-      - "pyrightconfig.json" # Affects type hints in docs
+      - ".github/workflows/build-docs.yml"
+      - ".ruff.toml"  # Affects docstrings via linting
+      - "pyrightconfig.json"  # Affects type hints in docs
 
   push:
     branches:
@@ -24,7 +23,7 @@ on:
       - "src/**/*.py"
       - "noxfile.py"
       - "pyproject.toml"
-      - ".github/workflows/docs-build.yml"
+      - ".github/workflows/build-docs.yml"
 
   workflow_dispatch:
 
@@ -46,7 +45,7 @@ jobs:
           python-version-file: ".github/workflows/.python-version"
 
       - name: Build documentation
-        run: uvx nox -s docs-build
+        run: uvx nox -s build-docs
 
       - name: Upload documentation (HTML) Artifact
         uses: actions/upload-artifact@v4

{{cookiecutter.project_name}}/noxfile.py

@@ -171,7 +171,7 @@ def tests_rust(session: Session) -> None:
 
 
 {% endif -%}
-@nox.session(python=DEFAULT_PYTHON_VERSION, name="docs-build", tags=[DOCS, BUILD])
+@nox.session(python=DEFAULT_PYTHON_VERSION, name="build-docs", tags=[DOCS, BUILD])
 def docs_build(session: Session) -> None:
     """Build the project documentation (Sphinx)."""
     session.log("Installing documentation dependencies...")