[GH-ISSUE #85] Consider using JSDoc-style function annotations everywhere #70

Closed
opened 2026-03-03 01:23:30 +03:00 by kerem · 2 comments
Owner

Originally created by @JoshuaKGoldberg on GitHub (Oct 30, 2017).
Original GitHub issue: https://github.com/DavidAnson/markdownlint/issues/85

Editors like Atom and VS Code will give better experiences when functions declare what their input and output types are.

Now:

image

With proper JSDoc:

image

Originally created by @JoshuaKGoldberg on GitHub (Oct 30, 2017). Original GitHub issue: https://github.com/DavidAnson/markdownlint/issues/85 Editors like Atom and VS Code will give better experiences when functions declare what their input and output types are. Now: ![image](https://user-images.githubusercontent.com/3335181/32150490-ef7901e2-bcd0-11e7-901f-043a28bfa9a3.png) With proper JSDoc: ![image](https://user-images.githubusercontent.com/3335181/32150497-12c988ba-bcd1-11e7-9f10-e317003da7e6.png)
kerem 2026-03-03 01:23:30 +03:00
Author
Owner

@DavidAnson commented on GitHub (Oct 30, 2017):

I do so for public functions, see function markdownlint for example. I have a note to look into // @ts-check (https://code.visualstudio.com/docs/languages/javascript) which would complement this for private functions.

<!-- gh-comment-id:340323024 --> @DavidAnson commented on GitHub (Oct 30, 2017): I do so for public functions, see `function markdownlint` for example. I have a note to look into `// @ts-check` (https://code.visualstudio.com/docs/languages/javascript) which would complement this for private functions.
Author
Owner

@JoshuaKGoldberg commented on GitHub (Oct 30, 2017):

public functions

👍. Title changed.

<!-- gh-comment-id:340325330 --> @JoshuaKGoldberg commented on GitHub (Oct 30, 2017): > public functions 👍. Title changed.
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
starred/markdownlint#70
No description provided.