Docs: method-signature-style lint rule ❤ --enforceReadonly compiler flag

[worstpractice]

Before You File a Documentation Request Please Confirm You Have Done The Following...

• I have looked for existing open or closed documentation requests that match my proposal.
• I have read the FAQ and my problem is not listed.

Suggested Changes

Just a heads up: another Hejlsberg PR comment detailing new upcoming footguns with method signatures.

In addition to their known issues, going forward, method signatures additionally will not enforce readonly type relationships with the coming --enforceReadonly TypeScript compiler flag enabled.

Including this new footgun specific to method signatures in the lint rule docs adds important context regarding the cost/benefit ratio (and reason-to-be) of the method-signature-style lint rule.

Naturally, if and when the --enforceReadonly flag lands in stable TypeScript would be the time to add this information to the method-signature-style docs.

Affected URL(s)

https://typescript-eslint.io/rules/method-signature-style/