On Sun, May 14, 2017 at 7:32 AM, Prateek Saxena <psaxena(a)wikimedia.org>
wrote:
On Sun, May 14, 2017 at 4:58 AM, Moriel Schottlender <moriel(a)gmail.com>
wrote:
By the way, I'm not entirely sure that's
true for jsdoc? I think it
expects
@inheritdoc? I am not sure, I may have missed the
explanation in the link
you provided.
I tested, and it does not require @inheritdoc. The documentation that
Ryan linked to says, "By default, if you do not add a JSDoc comment to
a symbol, the symbol will inherit documentation from its parent."
Note that we actually use a different tool to generate our documentation –
it's not JSDoc, it's JSDuck. In my experience it requires @inheritdoc at
least for properties, see e.g.
(the
behavior might differ for methods, I haven't tested it recently). We do
have a proposal to switch to JSDoc though: