Skip to content

Commit 804ebb1

Browse files
authored
[Doc] Move Release Compatibility Matrix to top and remove v0.7.x rc info (#799)
### What this PR does / why we need it? - Move Release Compatibility Matrix to top - Remove v0.7.x rc info because v0.7.3 final release alread published - Rename vllm-ascend to vLLM Ascend ### Does this PR introduce _any_ user-facing change? No ### How was this patch tested? Preview Signed-off-by: Yikun Jiang <yikunkero@gmail.com>
1 parent fa99f89 commit 804ebb1

File tree

1 file changed

+31
-34
lines changed

1 file changed

+31
-34
lines changed

docs/source/developer_guide/versioning_policy.md

Lines changed: 31 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ Starting with vLLM 0.7.x, the vLLM Ascend Plugin ([vllm-project/vllm-ascend](htt
44

55
## vLLM Ascend Plugin versions
66

7-
Each vllm-ascend release will be versioned: `v[major].[minor].[micro][rcN][.postN]` (such as
7+
Each vLLM Ascend release will be versioned: `v[major].[minor].[micro][rcN][.postN]` (such as
88
`v0.7.3rc1`, `v0.7.3`, `v0.7.3.post1`)
99

1010
- **Final releases**: will typically be released every **3 months**, will take the vLLM upstream release plan and Ascend software product release plan into comprehensive consideration.
@@ -13,12 +13,36 @@ Each vllm-ascend release will be versioned: `v[major].[minor].[micro][rcN][.post
1313

1414
For example:
1515
- `v0.7.x`: it's the first final release to match the vLLM `v0.7.x` version.
16-
- `v0.7.3rc1`: will be the first pre version of vllm-ascend.
16+
- `v0.7.3rc1`: will be the first pre version of vLLM Ascend.
1717
- `v0.7.3.post1`: will be the post release if the `v0.7.3` release has some minor errors.
1818

19+
## Release Compatibility Matrix
20+
21+
Following is the Release Compatibility Matrix for vLLM Ascend Plugin:
22+
23+
| vLLM Ascend | vLLM | Python | Stable CANN | PyTorch/torch_npu | MindIE Turbo |
24+
|--------------|--------------|----------------| --- | --- |
25+
| v0.8.5rc1 | v0.8.5.post1 | >= 3.9, < 3.12 | 8.1.RC1 | 2.5.1 / 2.5.1 |
26+
| v0.8.4rc2 | v0.8.4 | >= 3.9, < 3.12 | 8.0.0 | 2.5.1 / 2.5.1 |
27+
| v0.7.3 | v0.7.3 | >= 3.9, < 3.12 | 8.1.RC1 | 2.5.1 / 2.5.1 |
28+
29+
## Release cadence
30+
31+
### release window
32+
33+
| Date | Event |
34+
|------------|-------------------------------------------|
35+
| 2025.05.08 | v0.7.x Final release, v0.7.3 |
36+
| 2025.05.06 | Release candidates, v0.8.5rc1 |
37+
| 2025.04.28 | Release candidates, v0.8.4rc2 |
38+
| 2025.04.18 | Release candidates, v0.8.4rc1 |
39+
| 2025.03.28 | Release candidates, v0.7.3rc2 |
40+
| 2025.03.14 | Release candidates, v0.7.3rc1 |
41+
| 2025.02.19 | Release candidates, v0.7.1rc1 |
42+
1943
## Branch policy
2044

21-
vllm-ascend has main branch and dev branch.
45+
vLLM Ascend has main branch and dev branch.
2246

2347
- **main**: main branch,corresponds to the vLLM main branch and latest 1 or 2 release version. It is continuously monitored for quality through Ascend CI.
2448
- **vX.Y.Z-dev**: development branch, created with part of new releases of vLLM. For example, `v0.7.3-dev` is the dev branch for vLLM `v0.7.3` version.
@@ -36,9 +60,9 @@ The branch status will be in one of the following states:
3660

3761
### Branch state
3862

39-
Note that vllm-ascend will only be released for a certain vLLM release version rather than all versions. Hence, You might see only part of versions have dev branches (such as only `0.7.1-dev` / `0.7.3-dev` but no `0.7.2-dev`), this is as expected.
63+
Note that vLLM Ascend will only be released for a certain vLLM release version rather than all versions. Hence, You might see only part of versions have dev branches (such as only `0.7.1-dev` / `0.7.3-dev` but no `0.7.2-dev`), this is as expected.
4064

41-
Usually, each minor version of vLLM (such as 0.7) will correspond to a vllm-ascend version branch and support its latest version (for example, we plan to support version 0.7.3) as following shown:
65+
Usually, each minor version of vLLM (such as 0.7) will correspond to a vLLM Ascend version branch and support its latest version (for example, we plan to support version 0.7.3) as following shown:
4266

4367
| Branch | Status | Note |
4468
|------------|--------------|--------------------------------------|
@@ -48,9 +72,9 @@ Usually, each minor version of vLLM (such as 0.7) will correspond to a vllm-asce
4872

4973
### Backward compatibility
5074

51-
For main branch, vllm-ascend should works with vLLM main branch and latest 1 or 2 release version. So to ensure the backward compatibility, we will do the following:
75+
For main branch, vLLM Ascend should works with vLLM main branch and latest 1 or 2 release version. So to ensure the backward compatibility, we will do the following:
5276
- Both main branch and target vLLM release is tested by Ascend E2E CI. For example, currently, vLLM main branch and vLLM 0.8.4 are tested now.
53-
- For code changes, we will make sure that the changes are compatible with the latest 1 or 2 vLLM release version as well. In this case, vllm-ascend introduced a version check machinism inner the code. It'll check the version of installed vLLM pacakge first to decide which code logic to use. If users hit the `InvalidVersion` error, it sometimes means that they have installed an dev/editable version of vLLM package. In this case, we provide the env variable `VLLM_VERSION` to let users specify the version of vLLM package to use.
77+
- For code changes, we will make sure that the changes are compatible with the latest 1 or 2 vLLM release version as well. In this case, vLLM Ascend introduced a version check machinism inner the code. It'll check the version of installed vLLM pacakge first to decide which code logic to use. If users hit the `InvalidVersion` error, it sometimes means that they have installed an dev/editable version of vLLM package. In this case, we provide the env variable `VLLM_VERSION` to let users specify the version of vLLM package to use.
5478
- For documentation changes, we will make sure that the changes are compatible with the latest 1 or 2 vLLM release version as well. Note should be added if there are any breaking changes.
5579

5680
## Document Branch Policy
@@ -73,30 +97,3 @@ As shown above:
7397
every 3 months, a development version (aka the POC version) every month, and a nightly version every day.
7498
The PyPi stable version **CAN** be used in vLLM Ascend final version, the monthly dev version **ONLY CANN** be used in
7599
vLLM Ascend RC version for rapid iteration, the nightly version **CANNOT** be used in vLLM Ascend any version and branches.
76-
77-
## Release Compatibility Matrix
78-
79-
Following is the Release Compatibility Matrix for vLLM Ascend Plugin:
80-
81-
| vllm-ascend | vLLM | Python | Stable CANN | PyTorch/torch_npu |
82-
|--------------|--------------|----------------| --- | --- |
83-
| v0.8.5rc1 | v0.8.5.post1 | >= 3.9, < 3.12 | 8.1.RC1 | 2.5.1 / 2.5.1 |
84-
| v0.8.4rc2 | v0.8.4 | >= 3.9, < 3.12 | 8.0.0 | 2.5.1 / 2.5.1 |
85-
| v0.8.4rc1 | v0.8.4 | >= 3.9, < 3.12 | 8.0.0 | 2.5.1 / 2.5.1.dev20250320 |
86-
| v0.7.3rc2 | v0.7.3 | >= 3.9, < 3.12 | 8.0.0 | 2.5.1 / 2.5.1.dev20250320 |
87-
| v0.7.3rc1 | v0.7.3 | >= 3.9, < 3.12 | 8.0.0 | 2.5.1 / 2.5.1.dev20250308 |
88-
| v0.7.1rc1 | v0.7.1 | >= 3.9, < 3.12 | 8.0.0 | 2.5.1 / 2.5.1.dev20250218 |
89-
90-
## Release cadence
91-
92-
### release window
93-
94-
| Date | Event |
95-
|------------|-------------------------------------------|
96-
| Early of 2025.05 | v0.7.x Final release, v0.7.3 |
97-
| 2025.05.06 | Release candidates, v0.8.5rc1 |
98-
| 2025.04.28 | Release candidates, v0.8.4rc2 |
99-
| 2025.04.18 | Release candidates, v0.8.4rc1 |
100-
| 2025.03.28 | Release candidates, v0.7.3rc2 |
101-
| 2025.03.14 | Release candidates, v0.7.3rc1 |
102-
| 2025.02.19 | Release candidates, v0.7.1rc1 |

0 commit comments

Comments
 (0)