senchalabs/jsduck — Issue #83: Let @private hide public methods of parent class
Author: nene
Created: 2011-11-01 15:26:42+00:00
State: open

I have been reluctant to allow hiding of parent class
methods on the grounds that doing it would brake the
Liskov substitution principle. But I think I am finally
starting to see the light in the sense that the
documentation system shouldn't decide what the
programmer can or cannot do.

I guess that the current behavior when you mark a
subclass method with @private and still see the parent
class method appearing in docs is not what one
would expect. Only I, having internal knowledge of how
JSDuck works, would conclude that this makes
perfect sense.

So I finally agree that this indeed is a bug.

I'd still like to display some sort of notice
when subclass hides a method of parent, while I'd
like to keep this hidden method from appearing at
search.