[ https://issues.apache.org/jira/browse/FLINK-38242?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Weiqing Yang updated FLINK-38242: --------------------------------- Description: This ticket aims to improve the current upgrading documentation in two areas: 1. SQL/Table API State Compatibility Warning: The current compatibility guidelines do not clearly warn that SQL/Table API jobs can encounter state incompatibilities during minor version upgrades (e.g., 1.16 → 1.20) due to changes in query optimizers and operator topologies, giving the impression that the rules apply uniformly to all job types. 2. Missing Flink 2.x Versions: The compatibility table is missing Flink 2.0.x and 2.1.x versions. Changes needed: - Add clear warning about SQL/Table API state compatibility in the Compatibility Table section - Add Flink 2.0.x and 2.1.x rows to the compatibility table was: This ticket aims to improve the current upgrading documentation in two areas: 1. **SQL/Table API State Compatibility Warning**: The current compatibility guidelines do not clearly warn that SQL/Table API jobs can encounter state incompatibilities during minor version upgrades (e.g., 1.16 → 1.20) due to changes in query optimizers and operator topologies, giving the impression that the rules apply uniformly to all job types. 2. **Missing Flink 2.x Versions**: The compatibility table is missing Flink 2.0.x and 2.1.x versions. Changes needed: - Add clear warning about SQL/Table API state compatibility in the Compatibility Table section - Add Flink 2.0.x and 2.1.x rows to the compatibility table > Improve upgrading documentation for SQL/Table API state compatibility and add > Flink 2.x to compatibility table > -------------------------------------------------------------------------------------------------------------- > > Key: FLINK-38242 > URL: https://issues.apache.org/jira/browse/FLINK-38242 > Project: Flink > Issue Type: Improvement > Components: Documentation > Reporter: Weiqing Yang > Priority: Major > > This ticket aims to improve the current upgrading documentation in two areas: > 1. SQL/Table API State Compatibility Warning: The current compatibility > guidelines do not clearly warn that SQL/Table API jobs can encounter state > incompatibilities during minor version upgrades (e.g., 1.16 → 1.20) due to > changes in query optimizers and operator topologies, giving the impression > that the rules apply uniformly to all job types. > 2. Missing Flink 2.x Versions: The compatibility table is missing Flink 2.0.x > and 2.1.x versions. > Changes needed: > - Add clear warning about SQL/Table API state compatibility in the > Compatibility Table section > - Add Flink 2.0.x and 2.1.x rows to the compatibility table -- This message was sent by Atlassian Jira (v8.20.10#820010)