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

Sushanth Sowmyan commented on HIVE-9362:
----------------------------------------

Removing fix version of 1.2.0 in preparation of release, since this is not a 
blocker for 1.2.0.


> 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
>
> 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