On Sun, May 14, 2017 at 7:32 AM, Prateek Saxena psaxena@wikimedia.org wrote:
On Sun, May 14, 2017 at 4:58 AM, Moriel Schottlender moriel@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. https://phabricator.wikimedia.org/rGOJU0fad0c89b1f918e556db1687d45f2eb8bdfa2... (the behavior might differ for methods, I haven't tested it recently). We do have a proposal to switch to JSDoc though: https://phabricator.wikimedia.org/T138401 .