[jira] [Updated] (HIVE-9362) Document API Gurantees

["Sushanth Sowmyan (JIRA)" <ji...@apache.org>]

     [ https://issues.apache.org/jira/browse/HIVE-9362?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Sushanth Sowmyan updated HIVE-9362:
-----------------------------------
    Fix Version/s:     (was: 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)