[
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,
> hadoop-9517-v4.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
