Return-Path: X-Original-To: apmail-hbase-issues-archive@www.apache.org Delivered-To: apmail-hbase-issues-archive@www.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id 5AD38961D for ; Fri, 17 Feb 2012 23:17:18 +0000 (UTC) Received: (qmail 54554 invoked by uid 500); 17 Feb 2012 23:17:18 -0000 Delivered-To: apmail-hbase-issues-archive@hbase.apache.org Received: (qmail 54517 invoked by uid 500); 17 Feb 2012 23:17:18 -0000 Mailing-List: contact issues-help@hbase.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Delivered-To: mailing list issues@hbase.apache.org Received: (qmail 54509 invoked by uid 99); 17 Feb 2012 23:17:18 -0000 Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136) by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 17 Feb 2012 23:17:18 +0000 X-ASF-Spam-Status: No, hits=-2000.0 required=5.0 tests=ALL_TRUSTED,T_RP_MATCHES_RCVD X-Spam-Check-By: apache.org Received: from [140.211.11.116] (HELO hel.zones.apache.org) (140.211.11.116) by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 17 Feb 2012 23:17:17 +0000 Received: from hel.zones.apache.org (hel.zones.apache.org [140.211.11.116]) by hel.zones.apache.org (Postfix) with ESMTP id 2963C1BD97E for ; Fri, 17 Feb 2012 23:16:57 +0000 (UTC) Date: Fri, 17 Feb 2012 23:16:57 +0000 (UTC) From: "Jimmy Xiang (Updated) (JIRA)" To: issues@hbase.apache.org Message-ID: <803986696.52577.1329520617170.JavaMail.tomcat@hel.zones.apache.org> In-Reply-To: <854617132.25883.1315987929460.JavaMail.tomcat@hel.zones.apache.org> Subject: [jira] [Updated] (HBASE-4403) Adopt interface stability/audience classifications from Hadoop 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/HBASE-4403?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ] Jimmy Xiang updated HBASE-4403: ------------------------------- Attachment: hbase-4403-interface_v2.txt I got some distraction. Here is the v2 I have so far. I already added MiniZookeeper cluster as public, Evolving. I'd like to add MiniHBaseCluster as well but it is in test folder. Do we classify those classes in test folder? Should we move them to the main folder? > Adopt interface stability/audience classifications from Hadoop > -------------------------------------------------------------- > > Key: HBASE-4403 > URL: https://issues.apache.org/jira/browse/HBASE-4403 > Project: HBase > Issue Type: Task > Affects Versions: 0.90.5, 0.92.0 > Reporter: Todd Lipcon > Assignee: Jimmy Xiang > Attachments: hbase-4403-interface.txt, hbase-4403-interface_v2.txt, hbase-4403-nowhere-near-done.txt > > > As HBase gets more widely used, we need to be more explicit about which APIs are stable and not expected to break between versions, which APIs are still evolving, etc. We also have many public classes that are really internal to the RS or Master and not meant to be used by users. Hadoop has adopted a classification scheme for audience (public, private, or limited-private) as well as stability (stable, evolving, unstable). I think we should copy these annotations to HBase and start to classify our public classes. -- This message is automatically generated by JIRA. If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa For more information on JIRA, see: http://www.atlassian.com/software/jira