question-mark
Stuck on an issue?

Lightrun Answers was designed to reduce the constant googling that comes with debugging 3rd party libraries. It collects links to all the places you might be looking at while hunting down a tough bug.

And, if you’re still stuck at the end, we’re happy to hop on a call to see how we can help out.

Improve Doc comments

See original GitHub issue

This 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:closed
  • Created 3 years ago
  • Comments:5 (3 by maintainers)

github_iconTop GitHub Comments

1reaction
awaliascommented, Oct 1, 2020

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

1reaction
awaliascommented, Oct 1, 2020

thanks for the interest @fatmali , assigning you now 👍

Read more comments on GitHub >

github_iconTop 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 >

github_iconTop Related Medium Post

No results found

github_iconTop Related StackOverflow Question

No results found

github_iconTroubleshoot Live Code

Lightrun enables developers to add logs, metrics and snapshots to live code - no restarts or redeploys required.
Start Free

github_iconTop Related Reddit Thread

No results found

github_iconTop Related Hackernoon Post

No results found

github_iconTop Related Tweet

No results found

github_iconTop Related Dev.to Post

No results found

github_iconTop Related Hashnode Post

No results found