hadoop-common-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Vinod Kumar Vavilapalli (JIRA)" <j...@apache.org>
Subject [jira] [Commented] (HADOOP-9517) Document Hadoop Compatibility
Date Sun, 16 Jun 2013 00:17:20 GMT

    [ https://issues.apache.org/jira/browse/HADOOP-9517?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13684528#comment-13684528

Vinod Kumar Vavilapalli commented on HADOOP-9517:

Still to review the doc, but one more thing that I just discovered is that the published site
has apidocs which only show @Public APIs. This is different from regular javadoc that you
can generate with "mvn javadoc:javadoc" or what your favourite IDE shows. Given that, it is
confusing what is the source of truth of InterfaceAudience - Published javadoc on hadoop website
or what is present in jars themselves. If it's the later, it isn't clear what the policy is
for classes/interfaces with no annotations.
> Document Hadoop Compatibility
> -----------------------------
>                 Key: HADOOP-9517
>                 URL: https://issues.apache.org/jira/browse/HADOOP-9517
>             Project: Hadoop Common
>          Issue Type: Bug
>          Components: documentation
>            Reporter: Arun C Murthy
>            Assignee: Karthik Kambatla
>            Priority: Blocker
>         Attachments: hadoop-9517.patch, hadoop-9517.patch, hadoop-9517.patch, hadoop-9517.patch,
hadoop-9517-proposal-v1.patch, hadoop-9517-proposal-v1.patch, hadoop-9517-v2.patch, hadoop-9517-v3.patch,
> As we get ready to call hadoop-2 stable we need to better define 'Hadoop Compatibility'.
> http://wiki.apache.org/hadoop/Compatibility is a start, let's document requirements clearly
and completely.

This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira

View raw message