-
Notifications
You must be signed in to change notification settings - Fork 2.2k
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
jsdoc: add Orders, Shipping, Payment methods from core #3167
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.
A few questions
server/methods/core/orders.js
Outdated
// returns entire payment method | ||
/** | ||
* @name orderCreditMethod | ||
* @summary Helper to return the order credit object. |
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.
Does this one need a memberof Methods/Orders
tag?
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.
✔️
|
||
/** | ||
* @name createShipmentQuotes | ||
* @private |
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.
Do we need a summary for this private method?
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.
Not required but good to have.
/** | ||
* @summary if we have items in the cart, ensure that we only have shipping records for shops currently represented in the cart | ||
* @name pruneShippingRecordsByShop |
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.
Guessing we're not using the @membeof
here because it's private?
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.
Correct. @private
methods don't need @memberof
. But they should still have @summary
for people to read in the code itself.
Updated for comments + updated master branch |
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.
👍
eslint passes locally. |
…methods jsdoc: add Orders, Shipping, Payment methods from core
What this PR does
Methods/Orders
Methods/Shipping
Methods/Payment
What that renders