Read the Docs build information
Build id: 4286430
Project: anyscale-ray
Version: master
Commit: 10a891102d3c48e4da11977ca8d9bde2f1036159
Date: 2026-08-05T13:27:46.087701Z
State: cancelled
Success: False


[rtd-command-info] start-time: 2026-08-05T13:27:46.895642Z, end-time: 2026-08-05T13:27:58.791381Z, duration: 11, exit-code: 0
git clone --depth 1 https://github.com/ray-project/ray.git .
Cloning into '.'...
Updating files:  26% (2713/10212)
Updating files:  27% (2758/10212)
Updating files:  28% (2860/10212)
Updating files:  29% (2962/10212)
Updating files:  30% (3064/10212)
Updating files:  31% (3166/10212)
Updating files:  32% (3268/10212)
Updating files:  33% (3370/10212)
Updating files:  34% (3473/10212)
Updating files:  35% (3575/10212)
Updating files:  36% (3677/10212)
Updating files:  37% (3779/10212)
Updating files:  38% (3881/10212)
Updating files:  39% (3983/10212)
Updating files:  40% (4085/10212)
Updating files:  41% (4187/10212)
Updating files:  42% (4290/10212)
Updating files:  43% (4392/10212)
Updating files:  44% (4494/10212)
Updating files:  45% (4596/10212)
Updating files:  46% (4698/10212)
Updating files:  47% (4800/10212)
Updating files:  48% (4902/10212)
Updating files:  49% (5004/10212)
Updating files:  50% (5106/10212)
Updating files:  51% (5209/10212)
Updating files:  52% (5311/10212)
Updating files:  53% (5413/10212)
Updating files:  54% (5515/10212)
Updating files:  55% (5617/10212)
Updating files:  56% (5719/10212)
Updating files:  57% (5821/10212)
Updating files:  58% (5923/10212)
Updating files:  59% (6026/10212)
Updating files:  60% (6128/10212)
Updating files:  61% (6230/10212)
Updating files:  62% (6332/10212)
Updating files:  63% (6434/10212)
Updating files:  64% (6536/10212)
Updating files:  65% (6638/10212)
Updating files:  66% (6740/10212)
Updating files:  67% (6843/10212)
Updating files:  68% (6945/10212)
Updating files:  69% (7047/10212)
Updating files:  70% (7149/10212)
Updating files:  71% (7251/10212)
Updating files:  72% (7353/10212)
Updating files:  73% (7455/10212)
Updating files:  74% (7557/10212)
Updating files:  75% (7659/10212)
Updating files:  76% (7762/10212)
Updating files:  77% (7864/10212)
Updating files:  78% (7966/10212)
Updating files:  79% (8068/10212)
Updating files:  80% (8170/10212)
Updating files:  81% (8272/10212)
Updating files:  82% (8374/10212)
Updating files:  83% (8476/10212)
Updating files:  84% (8579/10212)
Updating files:  85% (8681/10212)
Updating files:  86% (8783/10212)
Updating files:  87% (8885/10212)
Updating files:  88% (8987/10212)
Updating files:  89% (9089/10212)
Updating files:  90% (9191/10212)
Updating files:  91% (9293/10212)
Updating files:  92% (9396/10212)
Updating files:  93% (9498/10212)
Updating files:  94% (9600/10212)
Updating files:  95% (9702/10212)
Updating files:  96% (9804/10212)
Updating files:  97% (9906/10212)
Updating files:  98% (10008/10212)
Updating files:  99% (10110/10212)
Updating files: 100% (10212/10212)
Updating files: 100% (10212/10212), done.

[rtd-command-info] start-time: 2026-08-05T13:27:58.864443Z, end-time: 2026-08-05T13:27:59.579245Z, duration: 0, exit-code: 0
git fetch origin --force --prune --prune-tags --depth 50 refs/heads/master:refs/remotes/origin/master


[rtd-command-info] start-time: 2026-08-05T13:28:00.209232Z, end-time: 2026-08-05T13:28:01.462043Z, duration: 1, exit-code: 0
git checkout --force origin/master
Note: switching to 'origin/master'.

You are in 'detached HEAD' state. You can look around, make experimental
changes and commit them, and you can discard any commits you make in this
state without impacting any branches by switching back to a branch.

If you want to create a new branch to retain commits you create, you may
do so (now or later) by using -c with the switch command. Example:

  git switch -c <new-branch-name>

Or undo this operation with:

  git switch -

Turn off this advice by setting config variable advice.detachedHead to false

HEAD is now at 10a8911 [ci] Reserve the doc tag for doc validation; route doc example tests per library (#64775)

[rtd-command-info] start-time: 2026-08-05T13:28:01.539644Z, end-time: 2026-08-05T13:28:01.577815Z, duration: 0, exit-code: 0
cat .readthedocs.yaml
# .readthedocs.yaml
# Read the Docs configuration file
# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details

# Required
version: 2

# Set the version of Python and other tools you might need
build:
  os: ubuntu-24.04
  tools:
    python: "3.11"
  jobs:
    # On PR builds, skip the Sphinx build when the PR doesn't touch any
    # files that affect documentation output. Reduces queue pressure on
    # the shared RTD build slots when several PRs are open at once.
    # Tag/branch builds (master, stable, etc.) always run.
    # The guard matches doc/ but excludes doc/.claude/ (Claude Code skills
    # and agent files), which never participate in the Sphinx build, so a
    # PR that changes only those paths skips the build instead of running one.
    # Code sources (python/ray/, rllib/) are intentionally not matched, so a
    # code-only PR skips this PR preview. The RTD PR check is not a required
    # merge gate, and the post-merge master build and the Buildkite doc_build
    # still render docstring-driven API-reference changes. This trades a
    # non-gating premerge preview for less pressure on the shared RTD slots.
    # See https://docs.readthedocs.com/platform/stable/guides/build/skip-build.html
    #
    # Some constructs are avoided deliberately because RTD's job runner
    # silently drops scripts that contain them: use echo (not printf
    # with a backslash-escape format string), avoid backslash escapes
    # in general, and keep shell comments out of this block so that
    # backticks/$() inside comments don't confuse the preprocessor.
    # The runner also strips the surrounding single quotes from arguments,
    # so use git's :! exclude shorthand rather than :(exclude): unquoted
    # parentheses reach /bin/sh (dash) and abort the script with a syntax error.
    post_checkout:
      - |
        if [ "${READTHEDOCS_VERSION_TYPE:-}" != "external" ]; then
          echo "Not a PR build (version type: '${READTHEDOCS_VERSION_TYPE:-unset}'); building docs."
          exit 0
        fi
        git fetch --depth=500 origin master 2>/dev/null || true
        if ! git merge-base origin/master HEAD >/dev/null 2>&1; then
          echo "Could not determine merge-base with origin/master; building docs to be safe."
          exit 0
        fi
        if git diff --quiet origin/master...HEAD -- doc/ ':!doc/.claude/' .readthedocs.yaml; then
          echo "No doc-affecting files changed in this PR; skipping Sphinx build."
          echo "Files changed in PR:"
          git diff --name-only origin/master...HEAD
          exit 183
        fi
        echo "Doc-affecting files changed; building docs. Changed doc-relevant paths:"
        git diff --name-only origin/master...HEAD -- doc/ ':!doc/.claude/' .readthedocs.yaml
    # Override the html build step so every build runs a full clean Sphinx
    # build via the doc/Makefile html target, for PR (external) previews and
    # branch/tag builds alike.
    #
    # The incremental-from-master-cache path added in #64277 is disabled for
    # now. On every PR preview Sphinx discards the restored cache because a
    # config value differs between the environment that produced the cache and
    # the RTD build environment, so it rebuilds all documents anyway while
    # still paying the cache download and extract cost, and it risks a second
    # clean rebuild when the incremental leg trips a warning. A clean build is
    # faster and lower-variance in practice today. Re-enable the incremental
    # path only once cache reuse is confirmed (Sphinx logs "N changed" rather
    # than "NNNN added") and stale-artifact pruning lands for PRs that rename
    # or delete sources. The rtd and rtd-fallback Makefile targets and
    # doc/load_doc_cache.py stay in the tree for that re-enable.
    build:
      html:
        - |
          make -C doc html HTMLDIR="$READTHEDOCS_OUTPUT/html"

# Build documentation in the docs/ directory with Sphinx
sphinx:
  configuration: doc/source/conf.py
  fail_on_warning: true

# We recommend specifying your dependencies to enable reproducible builds:
# https://docs.readthedocs.io/en/stable/guides/reproducible-builds.html
python:
  install:
    - requirements: doc/requirements-doc.lock.txt

[rtd-command-info] start-time: 2026-08-05T13:28:01.664708Z, end-time: 2026-08-05T13:28:01.701372Z, duration: 0, exit-code: 0
if [ "${READTHEDOCS_VERSION_TYPE:-}" != "external" ]; then
  echo "Not a PR build (version type: '${READTHEDOCS_VERSION_TYPE:-unset}'); building docs."
  exit 0
fi
git fetch --depth=500 origin master 2>/dev/null || true
if ! git merge-base origin/master HEAD >/dev/null 2>&1; then
  echo "Could not determine merge-base with origin/master; building docs to be safe."
  exit 0
fi
if git diff --quiet origin/master...HEAD -- doc/ ':!doc/.claude/' .readthedocs.yaml; then
  echo "No doc-affecting files changed in this PR; skipping Sphinx build."
  echo "Files changed in PR:"
  git diff --name-only origin/master...HEAD
  exit 183
fi
echo "Doc-affecting files changed; building docs. Changed doc-relevant paths:"
git diff --name-only origin/master...HEAD -- doc/ ':!doc/.claude/' .readthedocs.yaml
Not a PR build (version type: branch); building docs.

[rtd-command-info] start-time: 2026-08-05T13:28:06.308040Z, end-time: 2026-08-05T13:28:06.360461Z, duration: 0, exit-code: 0
asdf global python 3.11.15


[rtd-command-info] start-time: 2026-08-05T13:28:06.688827Z, end-time: 2026-08-05T13:28:07.271238Z, duration: 0, exit-code: 0
python -mvirtualenv $READTHEDOCS_VIRTUALENV_PATH
created virtual environment CPython3.11.15.final.0-64 in 357ms
  creator CPython3Posix(dest=/home/docs/checkouts/readthedocs.org/user_builds/anyscale-ray/envs/master, clear=False, no_vcs_ignore=False, global=False)
  seeder FromAppData(download=False, pip=bundle, setuptools=bundle, wheel=bundle, via=copy, app_data_dir=/home/docs/.local/share/virtualenv)
    added seed packages: pip==23.1, setuptools==67.6.1, wheel==0.40.0
  activators BashActivator,CShellActivator,FishActivator,NushellActivator,PowerShellActivator,PythonActivator

[rtd-command-info] start-time: 2026-08-05T13:28:07.368628Z, end-time: 2026-08-05T13:28:11.426007Z, duration: 4, exit-code: 0
python -m pip install --upgrade --no-cache-dir pip setuptools
Requirement already satisfied: pip in /home/docs/checkouts/readthedocs.org/user_builds/anyscale-ray/envs/master/lib/python3.11/site-packages (23.1)
Collecting pip
  Downloading pip-26.2.1-py3-none-any.whl (1.8 MB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 1.8/1.8 MB 18.7 MB/s eta 0:00:00
Requirement already satisfied: setuptools in /home/docs/checkouts/readthedocs.org/user_builds/anyscale-ray/envs/master/lib/python3.11/site-packages (67.6.1)
Collecting setuptools
  Downloading setuptools-83.0.0-py3-none-any.whl (1.0 MB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 1.0/1.0 MB 34.5 MB/s eta 0:00:00
Installing collected packages: setuptools, pip
  Attempting uninstall: setuptools
    Found existing installation: setuptools 67.6.1
    Uninstalling setuptools-67.6.1:
      Successfully uninstalled setuptools-67.6.1
  Attempting uninstall: pip
    Found existing installation: pip 23.1
    Uninstalling pip-23.1:
      Successfully uninstalled pip-23.1
Successfully installed pip-26.2.1 setuptools-83.0.0

[rtd-command-info] start-time: None, end-time: None, duration: None, exit-code: None
python -m pip install --upgrade --no-cache-dir sphinx