Hi Flink users and developers,

Currently, Flink won't generate doc for the deprecated options. This might 
confuse users when upgrading from an older version of Flink: they have to 
either carefully read the release notes or check the source code for upgrade 
guidance on deprecated options.

I propose to document deprecated options as well, with a "(deprecated)" tag 
placed at the beginning of the option description to highlight the deprecation 
status [1].

Looking forward to your feedbacks on it.

[1] https://issues.apache.org/jira/browse/FLINK-33240

Best,
Zhanghao Chen

Reply via email to