hive-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Thejas M Nair (JIRA)" <j...@apache.org>
Subject [jira] [Commented] (HIVE-9362) Document API Gurantees
Date Wed, 14 Jan 2015 19:33:35 GMT

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

Thejas M Nair commented on HIVE-9362:
-------------------------------------

bq.  I'd suggest we consider the Thrift API to be Public and Stable.
+1


> 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: 1.0.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)

Mime
View raw message