jsdoc @deprecated is not discoverable when compiled with the removeComments flag

[dnalborczyk]

because of this issue any jsdoc @ deprecated tags are not discoverable by users. e.g. this one:

federation/federation-js/src/service/buildSubgraphSchema.ts

Line 137 in 71e0dd1

* @deprecated Use `buildSubgraphSchema` instead.

depending on the timeline of the removal, some possible solutions:

• remove the flag to strip out comments
• in the above typescript issue is a workaround mentioned, essentially compiling twice: once for javascript, once for the ambient types. I don't think it's worth the trouble.
• one could (search and) inject the @ deprecated tag after the build into the ambient files.
• do nothing, leave as is - might be removed soon anyways

or better, one could also use the node.js wrapper function util.deprecate() which essentially writes a deprecated message [once for the lifetime of the application] to the console. doing so would notify javascript and typescript users regardless of what IDE has been used.

I can also provide a PR with the suggested wrapper.

[trevor-scheer]

Thanks @dnalborczyk, I like the last suggestion and TIL. Since these warnings are natively suppressible I'd certainly entertain a PR which implements this 👍