Skip to content

[CUDA] update doc for cuda contrib op GroupQueryAttention - #29173

Merged
tianleiwu merged 2 commits into
mainfrom
tlwu/update_cuda_gqa_doc
Jun 22, 2026
Merged

[CUDA] update doc for cuda contrib op GroupQueryAttention#29173
tianleiwu merged 2 commits into
mainfrom
tlwu/update_cuda_gqa_doc

Conversation

@tianleiwu

Copy link
Copy Markdown
Contributor

This pull request moves the docs/contrib_ops/gqa.md documentation file for the GroupQueryAttention contrib operator.
The file contained detailed information about the operator's schema, CUDA kernel backends, quantization, attention sink, and related implementation details.

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You can commit the suggested changes from lintrunner.

Comment thread onnxruntime/contrib_ops/cuda/bert/xqa/mha_impl.cuh Outdated
Comment thread onnxruntime/contrib_ops/cuda/bert/xqa/mha_impl.cuh Outdated

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR relocates the GroupQueryAttention contrib-op documentation from docs/contrib_ops/gqa.md to docs/contrib_ops/cuda/gqa.md, and expands it to focus on CUDA kernel behavior (dispatch, XQA, cuDNN SDPA, Flash/MEA/unfused), build options, and profiling/testing guidance.

Changes:

  • Move the GQA documentation into the CUDA-specific docs subtree (docs/contrib_ops/cuda/).
  • Add new sections covering input formats, backend selection controls (sdpa_kernel + env vars), profiling/benchmarking, fast build options, and known limitations/future work.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 4 comments.

File Description
docs/contrib_ops/gqa.md Removes the previous top-level GQA documentation file.
docs/contrib_ops/cuda/gqa.md Adds the relocated/expanded CUDA-focused GQA documentation (needs relative-link fixes after the move).

Comment thread docs/contrib_ops/cuda/gqa.md Outdated
Comment thread docs/contrib_ops/cuda/gqa.md Outdated
Comment thread docs/contrib_ops/cuda/gqa.md Outdated
Comment thread docs/contrib_ops/cuda/gqa.md Outdated
@tianleiwu
tianleiwu merged commit 8c08e94 into main Jun 22, 2026
85 checks passed
@tianleiwu
tianleiwu deleted the tlwu/update_cuda_gqa_doc branch June 22, 2026 16:53
Sign up for free to 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.

4 participants