Thanks for your proposal, Zhanghao Chen. I think it adds more transparency to the configuration documentation.
+1 from my side on the proposal On Wed, Oct 11, 2023 at 2:09 PM Zhanghao Chen <zhanghao.c...@outlook.com> wrote: > 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 >
