In part, the ambiguity results from Apple not wanting to be tied to specific implementation details
I think this makes sense, since the programmer should generally only be focused on the interface. The implementations details can and do change. I realize this is a tricky area, though.

didn't believe in a separate documentation group; he thought engineers could write documentation
Apple has a separate docs group today.