[jira] [Updated] (FLINK-15683) Restructure Documentation Docs

["Stephan Ewen (Jira)" <ji...@apache.org>]

     [ https://issues.apache.org/jira/browse/FLINK-15683?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Stephan Ewen updated FLINK-15683:
---------------------------------
    Labels: usability  (was: )

> Restructure Documentation Docs
> ------------------------------
>
>                 Key: FLINK-15683
>                 URL: https://issues.apache.org/jira/browse/FLINK-15683
>             Project: Flink
>          Issue Type: Improvement
>          Components: Documentation, Runtime / Configuration
>            Reporter: Stephan Ewen
>            Priority: Blocker
>              Labels: usability
>             Fix For: 1.11.0
>
>
> Currently, the configuration docs are very hard to parse. There is a minimal "common" section, and then all options are clustered by code component.
> The common options misses quite a lot of common options.
> The clustering by code component is not helpful to users, because it mixes options that are frequently necessary to adjust (for example task manager host) are mixed with options that should pretty much never be touched (other than during debugging), like taskmanager.registration.backoff.
> The subtasks will outline suggestions for improvements. 



--
This message was sent by Atlassian Jira
(v8.3.4#803005)