[ https://issues.apache.org/jira/browse/FLINK-32619?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17744606#comment-17744606 ]
Hong Liang Teoh commented on FLINK-32619: ----------------------------------------- That's a great callout [~wangm92] . Will use that instead and close this JIRA > ConfigOptions to support fallback configuration > ----------------------------------------------- > > Key: FLINK-32619 > URL: https://issues.apache.org/jira/browse/FLINK-32619 > Project: Flink > Issue Type: Technical Debt > Components: Runtime / Configuration > Affects Versions: 1.16.2, 1.17.1 > Reporter: Hong Liang Teoh > Priority: Minor > > ConfigOptions has no option to specify a "fallback configuration" as the > default. > > For example, if we want {{rest.cache.checkpoint-statistics.timeout}} to > fallback to web.refresh-interval instead of a static default value, we have > to specify > > {code:java} > @Documentation.OverrideDefault("web.refresh-interval") > @Documentation.Section(Documentation.Sections.EXPERT_REST) > public static final ConfigOption<Duration> > CACHE_CHECKPOINT_STATISTICS_TIMEOUT = > key("rest.cache.checkpoint-statistics.timeout") > .durationType() > .noDefaultValue() > .withDescription( > "...."); > {code} > > > The {{.noDefault()}} is misleading as it actually has a default. > > We should introduce a {{.fallbackConfiguration()}} that is handled gracefully > by doc generators. -- This message was sent by Atlassian Jira (v8.20.10#820010)