Skip to content

[Docs] Follow the upstream op list: drop the packed GQA prefill op, add FusedTopKOp - #45

Merged
lcy-seso merged 1 commit into
tile-ai:mainfrom
lcy-seso:docs/api-follow-upstream-moe-attention
Sep 5, 2026
Merged

[Docs] Follow the upstream op list: drop the packed GQA prefill op, add FusedTopKOp#45
lcy-seso merged 1 commit into
tile-ai:mainfrom
lcy-seso:docs/api-follow-upstream-moe-attention

Conversation

@lcy-seso

@lcy-seso lcy-seso commented Sep 5, 2026

Copy link
Copy Markdown
Contributor

problems

changes

  • Drop the GroupedQueryAttentionPrefillFwdOp entry from docs/api/attention.md.
  • Add FusedTopKOp to docs/api/moe.md, first under Routing and layout, since it picks each token's experts before the permutation runs; the intro paragraph lists that stage too.
  • Every mkdocstrings entry under docs/api/ now matches the __all__ of its upstream module, with no entry missing and none left over.
  • mkdocs build against a fresh upstream/main checkout of TileOPs: 0 errors, no warning outside griffe. pytest: 7 passed.

…dd FusedTopKOp

The daily refresh checks TileOPs out fresh, so an op that leaves `__all__`
upstream breaks the build the next morning. tile-ai/TileOPs#2058 removed
`GroupedQueryAttentionPrefillFwdOp`, and mkdocstrings aborted with
"Could not collect 'tileops.attention.GroupedQueryAttentionPrefillFwdOp'".

`tileops.moe.FusedTopKOp` is exported upstream and was never on the MoE page.
It runs before the permutation, so it goes first under Routing and layout.

Every mkdocstrings entry under docs/api/ now matches the `__all__` of its
upstream module, with no entry missing and none left over.
Copilot AI lite review requested due to automatic review settings September 5, 2026 13:23
@lcy-seso lcy-seso added the docs Documentation label Sep 5, 2026
@lcy-seso
lcy-seso merged commit b584298 into tile-ai:main Sep 5, 2026
3 checks passed
@lcy-seso
lcy-seso deleted the docs/api-follow-upstream-moe-attention branch September 5, 2026 13:25

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

🟢 Approval recommended

The changes are localized doc directive updates that remove a known-broken reference and add the missing upstream-exported op entry.

Pull request overview

Updates the API reference wrappers under docs/api/ to match the current upstream TileOPs exported operator list, unblocking mkdocstrings builds and ensuring the MoE API page includes the newly exported routing op.

Changes:

  • Removed the stale tileops.attention.GroupedQueryAttentionPrefillFwdOp mkdocstrings entry that was breaking the daily refresh/build.
  • Added tileops.moe.FusedTopKOp under “Routing and layout” and updated the MoE intro paragraph to reflect the routing stage.
File summaries
File Description
docs/api/moe.md Adds FusedTopKOp documentation and updates the page narrative to include expert-picking as a first-stage op.
docs/api/attention.md Drops the removed upstream prefill op entry so mkdocstrings no longer tries to import a non-existent symbol.
Review details
  • Files reviewed: 2/2 changed files
  • Comments generated: 0
  • Review effort level: Lite

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs Documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants