hive-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Brock Noland (JIRA)" <j...@apache.org>
Subject [jira] [Created] (HIVE-9362) Document API Gurantees
Date Tue, 13 Jan 2015 20:43:34 GMT
Brock Noland created HIVE-9362:
----------------------------------

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