[jira] [Commented] (FLINK-15192) consider split 'SQL' page into multiple sub pages for better clarity

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

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

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

+1 for this. I'm also frustrated by current SQL page, because the third-level titles are hidden. 
We can split the page into "Overview", "DDL" "DML", "Query" subpages under the "SQL" parent. 
I'm not sure whether "DQL" is a standard word, and maybe "Query" is safe and better. 

> consider split 'SQL' page into multiple sub pages for better clarity
> --------------------------------------------------------------------
>
>                 Key: FLINK-15192
>                 URL: https://issues.apache.org/jira/browse/FLINK-15192
>             Project: Flink
>          Issue Type: 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)