Return-Path: Delivered-To: apmail-hadoop-pig-dev-archive@www.apache.org Received: (qmail 56774 invoked from network); 19 Mar 2010 22:52:51 -0000 Received: from unknown (HELO mail.apache.org) (140.211.11.3) by 140.211.11.9 with SMTP; 19 Mar 2010 22:52:51 -0000 Received: (qmail 51842 invoked by uid 500); 19 Mar 2010 22:52:48 -0000 Delivered-To: apmail-hadoop-pig-dev-archive@hadoop.apache.org Received: (qmail 51825 invoked by uid 500); 19 Mar 2010 22:52:48 -0000 Mailing-List: contact pig-dev-help@hadoop.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: pig-dev@hadoop.apache.org Delivered-To: mailing list pig-dev@hadoop.apache.org Received: (qmail 51817 invoked by uid 99); 19 Mar 2010 22:52:48 -0000 Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136) by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 19 Mar 2010 22:52:48 +0000 X-ASF-Spam-Status: No, hits=-1075.4 required=10.0 tests=ALL_TRUSTED,AWL X-Spam-Check-By: apache.org Received: from [140.211.11.140] (HELO brutus.apache.org) (140.211.11.140) by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 19 Mar 2010 22:52:47 +0000 Received: from brutus.apache.org (localhost [127.0.0.1]) by brutus.apache.org (Postfix) with ESMTP id 4C390234C1F2 for ; Fri, 19 Mar 2010 22:52:27 +0000 (UTC) Message-ID: <331089875.377531269039147311.JavaMail.jira@brutus.apache.org> Date: Fri, 19 Mar 2010 22:52:27 +0000 (UTC) From: "Alan Gates (JIRA)" To: pig-dev@hadoop.apache.org Subject: [jira] Commented: (PIG-1311) Pig interfaces should be clearly classified in terms of scope and stability In-Reply-To: <906411638.377401269038787254.JavaMail.jira@brutus.apache.org> 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/PIG-1311?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12847632#action_12847632 ] Alan Gates commented on PIG-1311: --------------------------------- Hadoop has a proposal on how to approach this in HADOOP-5073 I propose we use the same nomenclature. Java interfaces would be marked via annotations (provided by Hadoop commons). For other interfaces we would need to provide version specific documents (that is, in forrest not in wiki) that detail scope and stability for each interface. > Pig interfaces should be clearly classified in terms of scope and stability > --------------------------------------------------------------------------- > > Key: PIG-1311 > URL: https://issues.apache.org/jira/browse/PIG-1311 > Project: Pig > Issue Type: Improvement > Reporter: Alan Gates > Assignee: Alan Gates > > Clearly marking Pig interfaces (Java interfaces but also things like config files, CLIs, Pig Latin syntax and semantics, etc.) to show scope (public/private) and stability (stable/evolving/unstable) will help users understand how to interact with Pig and developers to understand what things they can and cannot change. -- This message is automatically generated by JIRA. - You can reply to this email to add a comment to the issue online.