SIGN IN SIGN UP

[Doc] Add Triton operator description specification template (#14966)

## Why

There is currently no unified template for documenting Triton operators
under `vllm_ascend/ops/triton`. New operator docs tend to be written in
an ad-hoc way, making them hard to review and search.

## What

Add a specification template at
`vllm_ascend/ops/triton/docs/triton_description_specification.md`, which
defines a standardized structure for each Triton operator doc:

- **Description**: function, formula, algorithm flow, supported modes
- **Parameters**: table of parameter name / input-output-attribute /
description / data type / data format
- **Constraints**: shape, dtype, value range, constraints, and
graph-mode support of each input
- **Origin and Differences**: which vllm operator it is derived from,
and the NPU/vllm-ascend specific adaptations
- **Test Cases**: where single-operator accuracy tests should be placed,
and an example pytest command

## Notes

- Naming rule: docs are placed under `vllm_ascend/ops/triton/docs` and
named after the operator; add a suffix if the name already exists.
- Items that do not apply should be marked as "N/A" instead of left
blank.
- Test cases must use the actual shapes/parameters from the inference
scenario rather than arbitrarily constructed ones.

- vLLM version: v0.27.1
- vLLM main:
https://github.com/vllm-project/vllm/commit/ba07e4a48fc951300d97eb506217dd530583dea3

---------

Signed-off-by: ZT-AIA <1028681969@qq.com>
Z
ZT-AIA committed
d72770f5bc63346858f990837836d291dbe54887
Parent: 0a023b0
Committed by GitHub <noreply@github.com> on 8/28/2026, 2:02:31 AM