[jira] [Created] (FLINK-40383) Concept Glossary should be ordered alphabetically

["Lorenzo Nicora (Jira)" <ji...@apache.org>]

Lorenzo Nicora created FLINK-40383:
--------------------------------------

             Summary: Concept Glossary should be ordered alphabetically
                 Key: FLINK-40383
                 URL: https://issues.apache.org/jira/browse/FLINK-40383
             Project: Flink
          Issue Type: Improvement
          Components: Documentation
            Reporter: Lorenzo Nicora


The [Flink Glossary|https://nightlies.apache.org/flink/flink-docs-stable/docs/concepts/glossary/] entries are in alphabetical order.

A Glossary should be easily searchable for a specific term, with a ToC, or organized in subsection by theme, or in a predictable order (alphabetical).

In the Glossary, entries are organized with no clear criterial. There is some clustering by theme (e.g. {_}Flink Application Cluster{_}, {_}Flink Job Cluster{_}, {_}Flink Cluster{_}, but _Flink Session Cluster_ is elsewhere); other related concepts are ordered alphabetically (e.g. {_}Logical Graph{_}, {_}Physical Graph{_}); in some cases the prefix "Flink" is considered for the alphabetical ordering, in other is ignored.

The proposal is to order everything alphabetically, ignoring the prefix "Flink" to avoid a huge cluster around the "F".

Note: this issue was part of FLINK-40282, split to simplify reviewing



--
This message was sent by Atlassian Jira
(v8.20.10#820010)