-
Notifications
You must be signed in to change notification settings - Fork 15
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
1209 feature add jsdoc linter #1210
base: devel
Are you sure you want to change the base?
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
We failed to fetch the diff for pull request #1210
You can try again by commenting this pull request with @sourcery-ai review
, or contact us for help.
1211 fix jsdoc errors
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I made a few comments.
I believe the examples of endpoint usage are maybe misleading.
I'm also unsure about nested object attributes being marked as explicit params.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Some questions on example docs and specified files
Remove nested docs.
* output: ['usr', 'local', 'bin', 'node'] | ||
* @throws {Error} If the provided path is not a valid string. | ||
* | ||
* @example |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Should this example show usage as well? e.g. const splitPath = splitPOSIXPath(posixPath);
|
||
module.exports = [ | ||
{ | ||
ignores: ["docs/_static/**/*", "web/static/jquery/jquery.js", "web/node_modules"], |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Will this also run on build for the Foxx API?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
It runs for everything in the repo? Are you worried about a node_modules file in the foxx api? I don't think that will happen because foxx installs in the database not locally on the filesystem.
@@ -3188,9 +3189,12 @@ module.exports = (function () { | |||
}; | |||
|
|||
/** | |||
* Parses other_token_data string field and breaks it into pieces | |||
* | |||
* @param {integer} token_type - Type to determine parse logic. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
It didn't like my typing? 😢
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Looks good!
PR Description
Adding jsdoc linter will help to keep code changes consistent between developers and limit the intellectual overhead of seeing white space changes in the source code. This PR fixes the problem by using a formatter and a linter to help with code quality.
Tasks