Skip to content

docs: document graph runtime API - #22

Merged
voltjia merged 1 commit into
masterfrom
docs/graph-runtime-api-docs
Jul 9, 2026
Merged

docs: document graph runtime API#22
voltjia merged 1 commit into
masterfrom
docs/graph-runtime-api-docs

Conversation

@voltjia

Copy link
Copy Markdown
Collaborator

Summary

  • Document graph capture and replay types, functions, lifecycle, and usage in docs/api/runtime.md.
  • Add graph capture support status to docs/backends.md.
  • Update docs/compatibility.md so documented runtime types are part of the stable user-facing surface.

Motivation

PR #9 added the graph runtime API without corresponding user-facing documentation. This PR closes that documentation gap for the generated public runtime surface.

Closes #

Type of Change

  • feat - new feature / new operator / new platform
  • fix - bug fix
  • perf - performance improvement (no behavioral change)
  • refactor - code restructuring without behavior change
  • test - adding or fixing tests only
  • docs - documentation only
  • build / ci - build system or CI configuration
  • chore - tooling, formatting, or other non-code changes
  • Breaking change (requires a ! in the Conventional Commits prefix or a BREAKING CHANGE: footer)

Platforms Affected

  • CPU (WITH_CPU)
  • NVIDIA (WITH_NVIDIA)
  • Iluvatar (WITH_ILUVATAR)
  • MetaX (WITH_METAX)
  • Cambricon (WITH_CAMBRICON)
  • Moore (WITH_MOORE)
  • Ascend (WITH_ASCEND)
  • PyTorch C++ bindings (WITH_TORCH)
  • Build system / CMake / CI
  • Python bindings / user-facing API

Smoke Test Result

git diff --check
# passed
C:\Users\huang\.cache\codex-runtimes\codex-primary-runtime\dependencies\python\python.exe -c "... markdown relative link check ..."
Markdown relative links OK

cmake -S . -B build-docs -DWITH_CPU=ON -DINFINI_RT_BUILD_DOCS=ON was not run in this Windows workspace because cmake is not available on PATH. The previously used remote ssh nvidia validation path was also unavailable here because the nvidia host alias did not resolve.

Test Results on Supported Platforms

PlatformAffectedBuild / Smoke ResultFull Result / Notes
NVIDIANoN/A - docs onlyNot run
IluvatarNoN/A - docs onlyNot run
MetaXNoN/A - docs onlyNot run
CambriconNoN/A - docs onlyNot run
MooreNoN/A - docs onlyNot run
AscendNoN/A - docs onlyNot run
Full `pytest` output (optional)
N/A - documentation-only change.

Benchmark / Performance Impact

N/A - documentation-only change.

Notes for Reviewers

The graph API documentation intentionally describes that generated graph entry points depend on the configured build including a graph-capable backend.

@voltjia
voltjia merged commit 97de566 into masterJul 9, 2026
6 checks passed
@voltjia
voltjia deleted the docs/graph-runtime-api-docs branch July 9, 2026 05:01
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@voltjia