wuchong commented on a change in pull request #10669:
[FLINK-15192][docs][table] Restructure "SQL" pages for better readability
URL: https://github.com/apache/flink/pull/10669#discussion_r361904489
##########
File path: docs/dev/table/sql/queries.md
##########
@@ -145,7 +143,7 @@ table_env \
{% top %}
-### Supported Syntax
+## Supported Syntax
Review comment:
I think syntax is a summary of what is supported and is an entrypoint of the
features. Almost all the system are displaying syntax at the top of page, e.g.
[SQL
Server](https://docs.microsoft.com/en-us/sql/t-sql/queries/select-transact-sql),
[Spark](https://docs.databricks.com/spark/latest/spark-sql/language-manual/select.html),
[Hive](https://cwiki.apache.org/confluence/display/Hive/LanguageManual+Select).
If users are interested in the operations, they can jump to the detailed
section by TOC.
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
us...@infra.apache.org
With regards,
Apache Git Services
