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

Dawid Wysakowicz commented on FLINK-20239:
------------------------------------------

I am not the best with writing documentation. I'd ask [~sjwiesman] what he 
thinks.

Some of the points that I am clearly missing:
* stating that one is for batch the other for streaming (is it really though? 
the Hive streaming has also streaming/non-streaming mode: 
https://ci.apache.org/projects/flink/flink-docs-master/dev/table/hive/hive_streaming.html#streaming-source-enable)
* what is the difference between the reading/writing from "Hive Read & Write" 
and "Hive Streaming"
* I would definitely appreciate if everything about reading/writing was in a 
single place, not scattered into two pages without cross linking
* lastly I can't see any value in the "Hive Read & Write". It just states a few 
rather standard SQL statements. 

> Confusing pages: "Hive Read & Write" and "Hive Streaming"
> ---------------------------------------------------------
>
>                 Key: FLINK-20239
>                 URL: https://issues.apache.org/jira/browse/FLINK-20239
>             Project: Flink
>          Issue Type: Improvement
>          Components: Connectors / Hive, Documentation
>    Affects Versions: 1.12.0
>            Reporter: Dawid Wysakowicz
>            Priority: Critical
>             Fix For: 1.12.0
>
>
> The two pages describe how to read & write from Hive. It is not very clear 
> what is the relation between the two pages. Moreover the {{Hive Streaming}} 
> is way more comprehensive.
> Personally I found the {{Hive Read & Write}} page not helpful and bloated 
> with irrelevant sections such as e.g. Formats, Limit pushdown which often 
> contain a single sentence.



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

Reply via email to