Robert Kanter created YARN-5515:
-----------------------------------
Summary: Compatibility Docs should clarify the policy for what
takes precedence when a conflict is found
Key: YARN-5515
URL: https://issues.apache.org/jira/browse/YARN-5515
Project: Hadoop YARN
Issue Type: Task
Components: documentation
Affects Versions: 2.7.2
Reporter: Robert Kanter
The Compatibility Docs
(https://hadoop.apache.org/docs/r2.7.1/hadoop-project-dist/hadoop-common/Compatibility.html#Java_API)
list the policies for Private, Public, not annotated, etc Classes and members,
but it doesn't say what happens when there's a conflict. We should try
obviously try to avoid this situation, but it would be good to explicitly state
what takes precedence.
As an example, until YARN-3225 made it consistent, {{RefreshNodesRequest}}
looked like this:
{code:java}
@Private
@Stable
public abstract class RefreshNodesRequest {
@Public
@Stable
public static RefreshNodesRequest newInstance() {
RefreshNodesRequest request = Records.newRecord(RefreshNodesRequest.class);
return request;
}
}
{code}
Note that the class is marked {{\@Private}}, but the method is marked
{{\@Public}}.
In this example, I'd say that the class level should have priority.
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
