[jira] [Created] (FLINK-38242) Improve upgrading documentation for SQL/Table API state compatibility and add Flink 2.x to compatibility table

["Weiqing Yang (Jira)" <ji...@apache.org>]

Weiqing Yang created FLINK-38242:
------------------------------------

             Summary: 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


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)