[jira] [Commented] (FLINK-15192) Split 'SQL' page into multiple sub pages for better structure

["Jark Wu (Jira)" <ji...@apache.org>]

    [ https://issues.apache.org/jira/browse/FLINK-15192?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17002619#comment-17002619 ] 

Jark Wu commented on FLINK-15192:
---------------------------------

As discussed with [~Terry1897], I will continue to work on this issue. 
The proposed structure will be:

 SQL
    - Overview
    - Data Definition Language (DDL)
    - Data Manipulation Language (DML)
    - Data Retrieval (Query)

> Split 'SQL' page into multiple sub pages for better structure
> -------------------------------------------------------------
>
>                 Key: FLINK-15192
>                 URL: https://issues.apache.org/jira/browse/FLINK-15192
>             Project: Flink
>          Issue Type: Sub-task
>          Components: Documentation
>            Reporter: Bowen Li
>            Assignee: Terry Wang
>            Priority: Major
>             Fix For: 1.10.0
>
>
> with FLINK-15190, we are gonna add a bunch of ddl which makes the page too long and not really readable.
> I suggest split "SQL" page into sub pages of "SQL DDL", "SQL DML", "SQL DQL", and others if needed.
> assigned to Terry temporarily. 
> cc  [~jark] [~lzljs3620320] 
> As example, the SQL doc directory of Hive looks like below, which is a lot better that Flink's current one
> {code:java}
> CHILD PAGES
> Pages
> LanguageManual
> LanguageManual Cli
> LanguageManual DDL
> LanguageManual DML
> LanguageManual Select
> LanguageManual Joins
> LanguageManual LateralView
> LanguageManual Union
> LanguageManual SubQueries
> LanguageManual Sampling
> LanguageManual Explain
> LanguageManual VirtualColumns
> Configuration Properties
> LanguageManual ImportExport
> LanguageManual Authorization
> LanguageManual Types
> Literals
> LanguageManual VariableSubstitution
> LanguageManual ORC
> LanguageManual WindowingAndAnalytics
> LanguageManual Indexing
> LanguageManual JoinOptimization
> LanguageManual LZO
> LanguageManual Commands
> Parquet
> Enhanced Aggregation, Cube, Grouping and Rollup
> FileFormats
> Hive HPL/SQL
> {code}



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