Return-Path: X-Original-To: apmail-hive-dev-archive@www.apache.org Delivered-To: apmail-hive-dev-archive@www.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id 53EFC179CD for ; Wed, 14 Jan 2015 19:33:34 +0000 (UTC) Received: (qmail 76332 invoked by uid 500); 14 Jan 2015 19:33:35 -0000 Delivered-To: apmail-hive-dev-archive@hive.apache.org Received: (qmail 76263 invoked by uid 500); 14 Jan 2015 19:33:35 -0000 Mailing-List: contact dev-help@hive.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@hive.apache.org Delivered-To: mailing list dev@hive.apache.org Received: (qmail 76251 invoked by uid 500); 14 Jan 2015 19:33:35 -0000 Delivered-To: apmail-hadoop-hive-dev@hadoop.apache.org Received: (qmail 76248 invoked by uid 99); 14 Jan 2015 19:33:35 -0000 Received: from arcas.apache.org (HELO arcas.apache.org) (140.211.11.28) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 14 Jan 2015 19:33:35 +0000 Date: Wed, 14 Jan 2015 19:33:35 +0000 (UTC) From: "Thejas M Nair (JIRA)" To: hive-dev@hadoop.apache.org Message-ID: In-Reply-To: References: Subject: [jira] [Commented] (HIVE-9362) Document API Gurantees MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 7bit X-JIRA-FingerPrint: 30527f35849b9dde25b450d4833f0394 [ 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)