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

Reynold Xin commented on HIVE-9362:
-----------------------------------

It's great to see this ticket! It is an important step towards Hive being a 
platform and would be tremendously useful to Spark.

> Document API Gurantees
> ----------------------
>
>                 Key: HIVE-9362
>                 URL: https://issues.apache.org/jira/browse/HIVE-9362
>             Project: Hive
>          Issue Type: Task
>            Reporter: Brock Noland
>            Priority: Blocker
>             Fix For: 0.15.0
>
>
> This is an uber JIRA to document our API compatibility guarantees. Similar to 
> Hadoop I believe we should have 
> [InterfaceAudience|https://github.com/apache/hadoop/blob/trunk/hadoop-common-project/hadoop-annotations/src/main/java/org/apache/hadoop/classification/InterfaceAudience.java]
>  and 
> [InterfaceStability|https://github.com/apache/hadoop/blob/trunk/hadoop-common-project/hadoop-annotations/src/main/java/org/apache/hadoop/classification/InterfaceStability.java]
>  which I believe originally came from Sun.
> This project would be an effort by the Hive community including other 
> projects which depend on HIve API's to document which API's they use. 
> Although all API's that they use may not be considered {{Stable}} or even 
> {{Evolving}} we'll at least have any idea of who were are breaking when a 
> change is made.
> Beyond the Java API there is the Thrift API. Many projects directly use the 
> Thrift binding since we don't provide an API in say Python. As such I'd 
> suggest we consider the Thrift API to be {{Public}} and {{Stable}}.



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)

Reply via email to