@@ -10,23 +10,25 @@ that StableHLO provides, based on the process established in
10
10
The current version of StableHLO can be found in
11
11
[ Version.h] ( https://github.com/openxla/stablehlo/blob/main/stablehlo/dialect/Version.h#:~:text=getCurrentVersion ) .
12
12
13
- In the 0.x.x series, the minor version is bumped every time changes to
14
- the StableHLO opset or
13
+ The minor version is bumped every time changes to the StableHLO opset or
15
14
[ the StableHLO serialization format] ( bytecode.md ) are made, and the patch
16
15
version is bumped every time we integrate StableHLO downstream, i.e. into the
17
16
openxla/xla repository.
18
17
19
18
## Guarantees
20
19
21
- ** 6 months of backward compatibility:** Portable artifacts serialized by an old
20
+ Per the [ StableHLO v1.0 Compatibility RFC] ( https://github.com/openxla/stablehlo/blob/main/rfcs/20230623-compatibility.md ) ,
21
+ the compatibility window includes the following:
22
+
23
+ ** 5 years of backward compatibility:** Portable artifacts serialized by an old
22
24
version of libStablehlo have the same semantics* when deserialized by a new
23
25
version of libStablehlo if these versions are built from openxla/stablehlo
24
- commits which are less than 6 months apart.
26
+ commits which are less than 5 years apart.
25
27
26
- ** 1 month of forward compatibility:** Portable artifacts serialized by a new
28
+ ** 2 years of forward compatibility:** Portable artifacts serialized by a new
27
29
version of libStablehlo have the same semantics* when deserialized by an old
28
30
version of libStablehlo if these versions are built from openxla/stablehlo
29
- commits which are less than 1 month apart, unless the program is using new
31
+ commits which are less than 2 years apart, unless the program is using new
30
32
features introduced since the old version.
31
33
32
34
\* StableHLO programs are converted to/from portable artifacts via
0 commit comments