[FLINK-3793] Re-organize the Table API and SQL docs

• Type: Bug
• Status: Resolved
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 1.1.0
• Fix Version/s: 1.1.0
• Component/s: Documentation, Table SQL / API
• Assignee: Vasia Kalavri
• Reporter: Vasia Kalavri
• Created: 20/Apr/16 16:52
• Updated: 03/May/16 09:15
• Resolved: 03/May/16 09:15

Description

Now that we have added SQL and soon streaming SQL support, we need to reorganize the Table API documentation.

• The current guide is under "apis/batch/libs". We should either split it into a streaming and a batch part or move it to under "apis". The second option might be preferable, as the batch and stream APIs have a lot in common.
• The current guide has separate sections for Java and Scala APIs. These can be merged and organized with tabs, like other parts of the docs.
• Mentions of "Table API" can be renamed to "Table API and SQL", e.g. in the software stack figure and homepage.