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