Improve Doc comments
See original GitHub issueThis is a Hacktoberfest task! You can read more about Hacktoberfest on our blog and see all tasks on our Hacktoberfest Project Board.
Summary
We need help with checking and improving the inline comments for this library using JSDoc.
Details
If you’ve never see JSDoc before, it’s the comment that go above functions. For example:
/**
* Creates a new user.
*
* Some longer description can go here.
*
* @param {object} credentials The user login details.
* @param {string} credentials.email The user's email address.
* @param {string} credentials.password The user's password.
*/
async signUp(credentials: { email: string; password: string }) {
// ...
}
Issue Analytics
- State:
- Created 3 years ago
- Comments:5 (3 by maintainers)
Top Results From Across the Web
Modern Comments in Word - Microsoft Support
A consistent experience · Stay in control · Choose how you view comments · Resolve comment threads · Improved @mentions in comments ·...
Read more >Better Comments - Visual Studio Marketplace
The Better Comments extension will help you create more human-friendly comments in your code. With this extension, you will be able to ...
Read more >5 Top Tips for Giving Great Feedback on a Document
1. Be Specific. The worst thing you can do when editing a document is leave vague comments. If all you say is “This...
Read more >Guidelines to Better XML Doc Comments and Documentation
Guidelines to Better XML Doc Comments and Documentation ; 1. Don't hardcode true, false, null, Nothing, static and other language specific ...
Read more >Improve SyntaxFactory for documentation comments #218
Yes, we can do. But we want to provide a convenient way to easily create all kinds of documentation comment syntax one would...
Read more >
Top Related Medium Post
No results found
Top Related StackOverflow Question
No results found
Troubleshoot Live Code
Lightrun enables developers to add logs, metrics and snapshots to live code - no restarts or redeploys required.
Start Free
Top Related Reddit Thread
No results found
Top Related Hackernoon Post
No results found
Top Related Tweet
No results found
Top Related Dev.to Post
No results found
Top Related Hashnode Post
No results found
it looks like this one might actually already be complete, I couldn’t find any methods missing JSDocs at the moment - will wait for @kiwicopple to confirm
thanks for the interest @fatmali , assigning you now 👍