[jira] [Created] (FLINK-8744) Add annotations for documentation common/advanced options

classic Classic list List threaded Threaded
1 message Options
Reply | Threaded
Open this post in threaded view
|

[jira] [Created] (FLINK-8744) Add annotations for documentation common/advanced options

Shang Yuanchun (Jira)
Chesnay Schepler created FLINK-8744:
---------------------------------------

             Summary: Add annotations for documentation common/advanced options
                 Key: FLINK-8744
                 URL: https://issues.apache.org/jira/browse/FLINK-8744
             Project: Flink
          Issue Type: New Feature
          Components: Configuration, Documentation
            Reporter: Chesnay Schepler
            Assignee: Chesnay Schepler


The {{ConfigDocsGenerator}} only generates [the full configuration reference|https://ci.apache.org/projects/flink/flink-docs-master/ops/config.html#full-reference]. The [common|https://ci.apache.org/projects/flink/flink-docs-master/ops/config.html#common-options] and [advanced|https://ci.apache.org/projects/flink/flink-docs-master/ops/config.html#advanced-options] sections are still manually defined in {{config.md}} and thus prone to being outdated / out-of-sync with the full reference.

I propose adding {{@Common}}/{{@Advanced}} annotations based on which we could generate these sections as well.



--
This message was sent by Atlassian JIRA
(v7.6.3#76005)