JSDoc
TypeScript in Production notes about JSDoc
Publish and protect package APIs
Write TypeScript JSDoc Comments That Help API Consumers
Put usage guidance beside public declarations, leave types in TypeScript, and check how the comments read in editor help and generated reference pages.
