[arc-discuss] When should interfaces be private?

[John Plocher]

Philip Brown wrote:
> And having an interface stability level of "volatile" or "uncommitted" or 
> whatever, should mean exactly that they DONT HAVE TO "consult with anyone":


Both Volatile and Uncommitted have the attribute of "It is OK and
expected for you to use these interfaces".

Sometimes (many times!) that is simply not true - you should NOT be
using those interfaces unless you are a member of the project team
that is working on that code.

We identify *that* kind of interface by labeling it "Private".
And we document those interfaces in the code, in comments, in
internal design documents, in ARC cases, and many other places.
And sometimes, we don't.  Sometimes, "read the source, Luke"
is a valid expectation to have.

As Keith said, maybe we just need to agree to disagree.

   -John