Github user zentol commented on the issue:

    https://github.com/apache/flink/pull/3495
  
    2 more issues popped up:
    
    A large number of configuration parameters have not been ported yet (see 
[FLINK-4765](https://issues.apache.org/jira/browse/FLINK-4765) which means that 
we cannot use this for all options right away.
    
    More importantly, our organization of ConfigOptions isn't coherent with the 
existing organization in the docs. For example, all JobManager and WebFrontend 
options life in `JobManagerOptions`, but in the docs they are 2 different 
tables. The same issue applies to the Security Options, with SSl, Kerberos and 
Zookeper sharing the same file.
    
    Creating the tables based on the ConfigOption classes does not appear to be 
granular enough to provide a good documentation.
    
    I'm currently leaning towards adding annotations that group the contained 
config options based on a key prefix. Here's an example how it could look like 
for the `SecurityOptions`:
    
    ```
    @ConfigGroups(
        @ConfigGroup("Kerberos", "security.kerberos"),
        @ConfigGroup("SSL, "security.ssl"),
        @ConfigGroup("Zookeeper", "zookeeper"))
    public class SecurityOptions {
    }
    ```
    
    In this example we would use this annotation to generate 3 different 
tables, with proper names.


---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at infrastruct...@apache.org or file a JIRA ticket
with INFRA.
---

Reply via email to