Inherited methods not merging JSDoc comments

[LukeAbby]

Steps to reproduce

class Foo {
   /** foo bar */
   method(): void {}
}

class Bar extends Foo {
   /** @remarks lorem ipsum */
   method(): void {}
}

Behavior with typescript@5.9

Hovering over Bar#method gives:

(method) Bar.method(): void
foo bar
@remarks — lorem ipsum

Behavior with tsgo

Hovering over Bar#method gives:

(method) Bar.method(): void
@remarks — lorem ipsum

Note that the foo bar is gone. I believe that blocks like @remarks being merged is a case not handled by #2111

[ahejlsberg]

Hmm, I definitely agree that derived methods with no JSDoc should inherit JSDoc from base methods, but I'm not sure I like the notion of always merging the inherited JSDoc. Often the base documentation states what should happen in an override, which may be confusing to show in the description of an override that is actually present.

[ahejlsberg]

Actually, the old language service doesn't merge always merge inherited JSDoc. Rather, the summary and remarks sections are processed independently so that you might see the inherited summary of the base method but with the @remarks of the derived method. Or vice versa. I'm pretty sure things weren't intentionally designed that way, it just happened to work that way. I have to say I find the new behavior more understandable.