Override jsDoc with the actual usage

[mikrostew]

I've been running this, and noticed that when the jsDoc for a function is outdated, then rehearsal will prefer that to the actual usage in the code. Can this be updated to override any existing jsDoc types with the actual type that is used by the code?

I created #1183 to demonstrate this.

[egorio]

Hi @mikrostew Rehearsal prioritized "types from JSDoc" over "types from usage" (in drain mode) to give engineer more flexibility over inferred types. JSDoc allows you to describe more complex types than compiler can detect from usage.

I would recommend to just remove @param / @return from JSDoc and run Rehearsal fix to allow it to infer from usage.

Let's keep this ticket open, will think what we can do.

[lynchbomb]

Let's deprioritize this for now.

On the use-case the migrating code has invalid jsDoc directives the guidance is to simply delete the directive and re-run rehearsal.