[ https://issues.apache.org/jira/browse/HADOOP-6668?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12866179#action_12866179 ]
Sanjay Radia commented on HADOOP-6668: -------------------------------------- >> from the point of view of the user of an interface - unless is it declared >> as audience-public don't assume it is. >This is risky if they remain in the javadoc. Folks are accustomed to assuming >that documented APIs without other qualifications are APIs that will be >supported in the future. If you see the discussion in this and the other related Jiras, the assumption is that only interfaces marked as audience-public will appear in the user javadoc. Doesn;t this address your concern? > Apply audience and stability annotations to classes in common > ------------------------------------------------------------- > > Key: HADOOP-6668 > URL: https://issues.apache.org/jira/browse/HADOOP-6668 > Project: Hadoop Common > Issue Type: Sub-task > Components: documentation > Reporter: Tom White > Assignee: Tom White > Priority: Blocker > Fix For: 0.21.0 > > Attachments: common.interface-tw-annotated.txt, HADOOP-6668.patch, > HADOOP-6668.patch, HADOOP-6668.patch, HADOOP-6668.patch, HADOOP-6668.patch, > HADOOP-6668.patch > > > Mark private implementation classes with the InterfaceAudience.Private or > InterfaceAudience.LimitedPrivate annotation to exclude them from user Javadoc > and JDiff. -- This message is automatically generated by JIRA. - You can reply to this email to add a comment to the issue online.