Merge pull request #148 from rapidsai/branch-25.08

[RELEASE] cugraph-docs v25.08

Author: AyodeAwe

.github/workflows/build.yaml

@@ -9,15 +9,21 @@ on:
   workflow_dispatch:
     inputs:
       branch:
+        description: |
+          branch: git branch the workflow run targets.
+          Required even when 'sha' is provided because it is also used for organizing artifacts.
         required: true
         type: string
       date:
+        description: "date: Date (YYYY-MM-DD) this run is for. Used to organize artifacts produced by nightly builds"
         required: true
         type: string
       sha:
+        description: "sha: full git commit SHA to check out"
         required: true
         type: string
       build_type:
+        description: "build_type: one of [branch, nightly, pull-request]"
         type: string
         default: nightly
 
@@ -29,7 +35,7 @@ jobs:
   docs-build:
     if: github.ref_type == 'branch'
     secrets: inherit
-    uses: rapidsai/shared-workflows/.github/workflows/custom-job.yaml@branch-25.06
+    uses: rapidsai/shared-workflows/.github/workflows/custom-job.yaml@branch-25.08
     with:
       arch: "amd64"
       branch: ${{ inputs.branch }}

.github/workflows/pr.yaml

@@ -16,7 +16,7 @@ jobs:
       - checks
       - docs-build
     secrets: inherit
-    uses: rapidsai/shared-workflows/.github/workflows/pr-builder.yaml@branch-25.06
+    uses: rapidsai/shared-workflows/.github/workflows/pr-builder.yaml@branch-25.08
     if: always()
     with:
       needs: ${{ toJSON(needs) }}
@@ -31,31 +31,26 @@ jobs:
   checks:
     secrets: inherit
     needs: telemetry-setup
-    uses: rapidsai/shared-workflows/.github/workflows/checks.yaml@branch-25.06
+    uses: rapidsai/shared-workflows/.github/workflows/checks.yaml@branch-25.08
     with:
       enable_check_generated_files: false
       ignored_pr_jobs: "telemetry-summarize"
   docs-build:
     needs: checks
     secrets: inherit
-    uses: rapidsai/shared-workflows/.github/workflows/custom-job.yaml@branch-25.06
+    uses: rapidsai/shared-workflows/.github/workflows/custom-job.yaml@branch-25.08
     with:
       build_type: pull-request
       node_type: "gpu-l4-latest-1"
       arch: "amd64"
       container_image: "rapidsai/ci-conda:latest"
       script: "ci/build_docs.sh"
   telemetry-summarize:
-    runs-on: ubuntu-latest
+    # This job must use a self-hosted runner to record telemetry traces.
+    runs-on: linux-amd64-cpu4
     needs: pr-builder
-    if: always()
+    if: ${{ vars.TELEMETRY_ENABLED == 'true' && !cancelled() }}
     continue-on-error: true
     steps:
-      - name: Load stashed telemetry env vars
-        uses: rapidsai/shared-actions/telemetry-dispatch-load-base-env-vars@main
-        with:
-            load_service_name: true
       - name: Telemetry summarize
-        uses: rapidsai/shared-actions/telemetry-dispatch-write-summary@main
-        with:
-          cert_concat: "${{ secrets.OTEL_EXPORTER_OTLP_CA_CERTIFICATE }};${{ secrets.OTEL_EXPORTER_OTLP_CLIENT_CERTIFICATE }};${{ secrets.OTEL_EXPORTER_OTLP_CLIENT_KEY }}"
+        uses: rapidsai/shared-actions/telemetry-dispatch-summarize@main

.pre-commit-config.yaml

@@ -7,7 +7,7 @@ repos:
       - id: verify-alpha-spec
       - id: verify-copyright
   - repo: https://github.com/rapidsai/dependency-file-generator
-    rev: v1.18.1
+    rev: v1.19.0
     hooks:
       - id: rapids-dependency-file-generator
         args: ["--clean"]
@@ -16,7 +16,6 @@ repos:
     hooks:
       - id: shellcheck
         args: ["--severity=warning"]
-        files: ^ci/
 
 default_language_version:
   python: python3

CHANGELOG.md

@@ -1,3 +1,31 @@
+# cugraph-docs 25.08.00 (6 Aug 2025)
+
+## 🚨 Breaking Changes
+
+- remove cugraph-dgl references ([#146](https://github.com/rapidsai/cugraph-docs/pull/146)) [@jameslamb](https://github.com/jameslamb)
+
+## 🐛 Bug Fixes
+
+- Update telemetry-summarize ([#136](https://github.com/rapidsai/cugraph-docs/pull/136)) [@msarahan](https://github.com/msarahan)
+
+## 📖 Documentation
+
+- added new blogs for 2025 and fixed cuda docs per review comment ([#143](https://github.com/rapidsai/cugraph-docs/pull/143)) [@acostadon](https://github.com/acostadon)
+- Removing CUDA 11 references and fixing outdated wholegraph info ([#141](https://github.com/rapidsai/cugraph-docs/pull/141)) [@acostadon](https://github.com/acostadon)
+- Adds Commmunity and Louvain landing pages ([#139](https://github.com/rapidsai/cugraph-docs/pull/139)) [@acostadon](https://github.com/acostadon)
+- add docs on CI workflow inputs ([#137](https://github.com/rapidsai/cugraph-docs/pull/137)) [@jameslamb](https://github.com/jameslamb)
+- Fixing links issues with Sphinx ([#134](https://github.com/rapidsai/cugraph-docs/pull/134)) [@acostadon](https://github.com/acostadon)
+- minimal path change and added hyphen to verify version ([#133](https://github.com/rapidsai/cugraph-docs/pull/133)) [@acostadon](https://github.com/acostadon)
+- changed the formulas to match myst-parser ([#132](https://github.com/rapidsai/cugraph-docs/pull/132)) [@acostadon](https://github.com/acostadon)
+
+## 🛠️ Improvements
+
+- remove cugraph-dgl references ([#146](https://github.com/rapidsai/cugraph-docs/pull/146)) [@jameslamb](https://github.com/jameslamb)
+- Remove channels ([#138](https://github.com/rapidsai/cugraph-docs/pull/138)) [@vyasr](https://github.com/vyasr)
+- Use CUDA 12.9 in Conda, Devcontainers, Spark, GHA, etc. ([#135](https://github.com/rapidsai/cugraph-docs/pull/135)) [@jakirkham](https://github.com/jakirkham)
+- refactor(shellcheck): fix all shellcheck warnings/errors ([#131](https://github.com/rapidsai/cugraph-docs/pull/131)) [@gforsyth](https://github.com/gforsyth)
+- Forward-merge branch-25.06 into branch-25.08 ([#119](https://github.com/rapidsai/cugraph-docs/pull/119)) [@gforsyth](https://github.com/gforsyth)
+
 # cugraph-docs 25.06.00 (5 Jun 2025)
 
 ## 🐛 Bug Fixes

VERSION

@@ -1 +1 @@
-25.06.00
+25.08.00

build.sh

@@ -16,7 +16,7 @@ ARGS=$*
 
 # NOTE: ensure all dir changes are relative to the location of this
 # script, and that this script resides in the repo dir!
-REPODIR=$(cd $(dirname $0); pwd)
+REPODIR=$(cd "$(dirname "$0")"; pwd)
 
 RAPIDS_VERSION="$(sed -E -e 's/^([0-9]{2})\.([0-9]{2})\.([0-9]{2}).*$/\1.\2/' VERSION)"
 
@@ -37,7 +37,6 @@ HELP="$0 [<target> ...] [<flag> ...]
    clean                      - remove all existing build artifacts and configuration (start over)
    docs                       - build the docs (default)
  and <flag> is:
-   -v                         - verbose build mode
    --clean                    - clean
    -h                         - print this text
 
@@ -46,15 +45,12 @@ HELP="$0 [<target> ...] [<flag> ...]
 "
 
 
-# Set defaults for vars modified by flags to this script
-VERBOSE_FLAG=""
-
 function hasArg {
-    (( ${NUMARGS} != 0 )) && (echo " ${ARGS} " | grep -q " $1 ")
+    (( NUMARGS != 0 )) && (echo " ${ARGS} " | grep -q " $1 ")
 }
 
 function buildDefault {
-    (( ${NUMARGS} == 0 )) || !(echo " ${ARGS} " | grep -q " [^-][a-zA-Z0-9\_\-]\+ ")
+    (( NUMARGS == 0 )) || ! (echo " ${ARGS} " | grep -q " [^-][a-zA-Z0-9\_\-]\+ ")
 }
 
 
@@ -64,7 +60,7 @@ if hasArg -h || hasArg --help; then
 fi
 
 # Check for valid usage
-if (( ${NUMARGS} != 0 )); then
+if (( NUMARGS != 0 )); then
     for a in ${ARGS}; do
         if ! (echo "${VALIDARGS}" | grep -q "^[[:blank:]]*${a}$"); then
             echo "Invalid option: ${a}"
@@ -73,19 +69,12 @@ if (( ${NUMARGS} != 0 )); then
     done
 fi
 
-# Process flags
-if hasArg -v; then
-    VERBOSE_FLAG="-v"
-fi
-
-
-
 if hasArg clean; then
     # Ignore errors for clean since missing files, etc. are not failures
     set +e
 
     # Clean up the docs
-    cd ${REPODIR}/docs/cugraph-docs
+    cd "${REPODIR}"/docs/cugraph-docs
     make clean
     # Go back to failing on first error for all other operations
     set -e
@@ -94,13 +83,13 @@ fi
 # Build the docs
 # C/C++?CUDA libraries
 if hasArg docs || buildDefault; then
-    PROJ_LIST=("libcugraph libwholegraph")
-    for PROJECT in ${PROJ_LIST}; do
+    PROJ_LIST=("libcugraph" "libwholegraph")
+    for PROJECT in "${PROJ_LIST[@]}"; do
         echo "PROJECT IS ${PROJECT}"
         XML_DIR="${REPODIR}/docs/cugraph-docs/${PROJECT}"
         rm -rf "${XML_DIR}"
         mkdir -p "${XML_DIR}"
-        export XML_DIR_${PROJECT^^}="$XML_DIR"
+        export XML_DIR_"${PROJECT^^}"="$XML_DIR"
         echo "Pulling https://d1664dvumjb44w.cloudfront.net/${PROJECT}/xml_tar/${RAPIDS_VERSION}/xml.tar.gz"
         curl -O "https://d1664dvumjb44w.cloudfront.net/${PROJECT}/xml_tar/${RAPIDS_VERSION}/xml.tar.gz"
 
@@ -114,6 +103,6 @@ if hasArg docs || buildDefault; then
 
     #export XML_DIR_LIBCUGRAPH="${REPODIR}/cpp/doxygen/xml"
 
-    cd ${REPODIR}/docs/cugraph-docs
+    cd "${REPODIR}"/docs/cugraph-docs
     make html
-fi
+fi

ci/release/update-version.sh

@@ -44,7 +44,6 @@ NEXT_SHORT_TAG_PEP440=$(python -c "from packaging.version import Version; print(
 
 DEPENDENCIES=(
   cugraph
-  cugraph-dgl
   cugraph-pyg
   libcugraph
   libcugraph_etl

conda/environments/all_cuda-129_arch-x86_64.yaml

@@ -4,30 +4,26 @@ channels:
 - pyg
 - rapidsai
 - rapidsai-nightly
-- dask/label/dev
 - conda-forge
-- nvidia
 dependencies:
 - breathe>=4.35
 - cuda-version=12.9
-- cugraph-dgl==25.6.*,>=0.0.0a0
-- cugraph-pyg==25.6.*,>=0.0.0a0
-- cugraph==25.6.*,>=0.0.0a0
-- dglteam/label/th24_cu124::dgl
+- cugraph-pyg==25.8.*,>=0.0.0a0
+- cugraph==25.8.*,>=0.0.0a0
 - doxygen
 - graphviz
 - ipython
-- libcugraph==25.6.*,>=0.0.0a0
-- libcugraph_etl==25.6.*,>=0.0.0a0
+- libcugraph==25.8.*,>=0.0.0a0
+- libcugraph_etl==25.8.*,>=0.0.0a0
+- myst-parser>=0.13
 - nbsphinx
 - numpydoc
 - pre-commit
 - pydata-sphinx-theme
-- pylibcugraph==25.6.*,>=0.0.0a0
-- pylibwholegraph==25.6.*,>=0.0.0a0
-- recommonmark
+- pylibcugraph==25.8.*,>=0.0.0a0
+- pylibwholegraph==25.8.*,>=0.0.0a0
+- sphinx
 - sphinx-copybutton
 - sphinx-markdown-tables
-- sphinx>=8,<8.2.0
 - sphinxcontrib-websupport
 name: all_cuda-129_arch-x86_64

dependencies.yaml

@@ -26,9 +26,7 @@ channels:
   - pyg
   - rapidsai
   - rapidsai-nightly
-  - dask/label/dev
   - conda-forge
-  - nvidia
 dependencies:
   checks:
     common:
@@ -68,14 +66,13 @@ dependencies:
           - doxygen
           - graphviz
           - ipython
+          - myst-parser>=0.13
           - nbsphinx
           - numpydoc
           - pydata-sphinx-theme
-          - recommonmark
           - sphinx-copybutton
           - sphinx-markdown-tables
-          # the ceiling on sphinx can be removed when https://github.com/spatialaudio/nbsphinx/issues/825 is resolved
-          - sphinx>=8,<8.2.0
+          - sphinx
           - sphinxcontrib-websupport
 
   # this repo only uses conda and 1 major version of CUDA, so
@@ -84,11 +81,9 @@ dependencies:
     common:
       - output_types: [conda]
         packages:
-          - cugraph==25.6.*,>=0.0.0a0
-          - cugraph-dgl==25.6.*,>=0.0.0a0
-          - cugraph-pyg==25.6.*,>=0.0.0a0
-          - 'dglteam/label/th24_cu124::dgl'
-          - libcugraph==25.6.*,>=0.0.0a0
-          - libcugraph_etl==25.6.*,>=0.0.0a0
-          - pylibcugraph==25.6.*,>=0.0.0a0
-          - pylibwholegraph==25.6.*,>=0.0.0a0
+          - cugraph==25.8.*,>=0.0.0a0
+          - cugraph-pyg==25.8.*,>=0.0.0a0
+          - libcugraph==25.8.*,>=0.0.0a0
+          - libcugraph_etl==25.8.*,>=0.0.0a0
+          - pylibcugraph==25.8.*,>=0.0.0a0
+          - pylibwholegraph==25.8.*,>=0.0.0a0