Skip to content

Fix stale ContribOperators.md for MRotaryEmbedding - #31985

Merged
Tianlei Wu (tianleiwu) merged 1 commit into
microsoft:mainfrom
justinchuby:nxrt/fix-mrope-contrib-doc
Aug 12, 2026
Merged

Fix stale ContribOperators.md for MRotaryEmbedding#31985
Tianlei Wu (tianleiwu) merged 1 commit into
microsoft:mainfrom
justinchuby:nxrt/fix-mrope-contrib-doc

Conversation

@justinchuby

Copy link
Copy Markdown
Contributor

Summary

docs/ContribOperators.md disagrees with the schema that generates it for the MRotaryEmbedding operator, causing the Windows GPU Kernel Documentation Validation CI check to fail on every PR merged to main.

Root cause

PR #31728 (e415ef9afd) added the fused MRotaryEmbedding contrib op. The checked-in doc contains:

setting `mrope_section` to a single full-width section
(or omitting it) reduces this op to standard RoPE.

but the schema in onnxruntime/core/graph/contrib_ops/bert_defs.cc (and correspondingly the output of gen_contrib_doc.py) says:

setting `mrope_section` to a single full-width section
reduces this op to standard RoPE.

The parenthetical (or omitting it) is also semantically incorrect — mrope_section is declared as a required attribute (AttributeProto::INTS with no default), so it cannot be omitted.

Fix

Remove the inaccurate parenthetical from the checked-in doc to match the schema/generator output.

-  (or omitting it) reduces this op to standard RoPE.
+  reduces this op to standard RoPE.

This is a hand-edit matching exactly what the generator (tools/ci_build/gen_contrib_doc.py --domains com.microsoft) produces. I did not run the generator because it requires built Python bindings.

Impact

Unblocks the documentation validation CI check for all open PRs targeting main.

The checked-in doc contained '(or omitting it) reduces this op to
standard RoPE' but the schema in bert_defs.cc (and the generator output)
says 'reduces this op to standard RoPE' — without the parenthetical.
mrope_section is a required attribute so the phrase was also semantically
incorrect.

This was introduced in microsoft#31728 (e415ef9) and causes the
'Windows GPU Kernel Documentation Validation' CI check to fail on every
PR merged to main.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@justinchuby
Justin Chu (justinchuby) marked this pull request as ready for review August 11, 2026 20:13
@tianleiwu
Tianlei Wu (tianleiwu) merged commit f2dfa4e into microsoft:main Aug 12, 2026
87 checks passed
Danny On The Air (dannyota) added a commit to dannyota/onnxruntime that referenced this pull request Aug 12, 2026
Picks up the ContribOperators.md regeneration (microsoft#31985), which fixes the
Windows GPU Kernel Documentation Validation failure. That check was
failing on main independently of this branch.

The Go binding CI wiring in linux_ci.yml and reusable_linux_build.yml
auto-merged cleanly and is unchanged.
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.

2 participants