Added a script to update docs

Author: kohsuke

README.md

@@ -115,6 +115,21 @@ When updating the Python version requirement, update the following files:
 Create new release on Github, then Github Actions automatically uploads the
 module to PyPI.
 
+## How to update bundled documentation
+
+The product documentation lives in `smart_tests/docs/` and is bundled into the
+distributed package. To pull in the latest from the docsite repository:
+
+```shell
+uv run poe update-docs
+```
+
+Users can extract the bundled docs to the current directory with:
+
+```shell
+smart-tests get docs
+```
+
 ## How to update smart_tests/jar/exe_deploy.jar
 
 ```

pyproject.toml

@@ -52,6 +52,7 @@ lint-warn = "flake8 --count --exit-zero --max-complexity=15 --max-line-length=13
 test = "python -m unittest"
 test-xml = "python -m test-runner"
 type = "mypy smart_tests tests"
+update-docs = "bash scripts/update_docs.sh"
 
 [build-system]
 requires = ["setuptools>=45", "wheel", "setuptools_scm"]

scripts/update_docs.sh

@@ -0,0 +1,15 @@
+#!/bin/bash
+# Fetch the latest docs from the docsite repository into smart_tests/docs/.
+# Run via: uv run poe update-docs
+set -euo pipefail
+
+REPO="git@github.com:cloudbees/docsite-cloudbees-smart-tests.git"
+DOCS_DST="$(dirname "$0")/../smart_tests/docs"
+
+tmpdir=$(mktemp -d)
+trap 'rm -rf "$tmpdir"' EXIT
+
+git clone --depth=1 "$REPO" "$tmpdir"
+rm -rf "$DOCS_DST"
+cp -r "$tmpdir/docs" "$DOCS_DST"
+echo "Docs updated at $DOCS_DST"