LICO67373 c8a324ab73 [Refactor] Add comments for Metadata classes in attention module (#5789) ...

### What this PR does / why we need it?

Add docstrings for Metadata and MetadataBuilder classes in the attention
module to improve code readability.

Related to #5463 (Item 11: Add some comments for CommonMetadata and
others)

**Modified files:**
- `vllm_ascend/attention/context_parallel/common_cp.py`: Added comments
for `AscendPCPMetadata`, `CPChunkedContextMetadata`,
`AscendMetadataForPrefill`, `AscendMetadataForDecode`
- `vllm_ascend/attention/utils.py`: Added comments for
`AscendPrefillContextParallelMetadata`
- `vllm_ascend/attention/mla_v1.py`: Added comments for
`ChunkedContextMetadata`, `AscendMLADecodeMetadata`
- `vllm_ascend/attention/attention_v1.py`: Added comments for
`AscendMetadata`, `AscendAttentionMetadataBuilder`
- `vllm_ascend/attention/context_parallel/attention_cp.py`: Added
comments for `AscendAttentionCPMetadataBuilder`

### Does this PR introduce _any_ user-facing change?

No.

### How was this patch tested?

Documentation only, no functional changes.

Signed-off-by: lico67373 <918688502@qq.com>

2026-01-13 08:46:50 +08:00

..

__init__.py

[Refactor]7/N Extract common code to common_cp (#5490)

2026-01-05 17:41:12 +08:00

attention_cp.py

[Refactor] Add comments for Metadata classes in attention module (#5789)

2026-01-13 08:46:50 +08:00

common_cp.py

[Refactor] Add comments for Metadata classes in attention module (#5789)

2026-01-13 08:46:50 +08:00

mla_cp.py

[bugfix](cp) align max_context_chunk to cp_virtual_block_size (#5767)

2026-01-12 20:11:46 +08:00