-
Notifications
You must be signed in to change notification settings - Fork 1.1k
Add js docs for Authentication package #405
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
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.
Looks mostly good. I haven't checked whether all authentication entities are covered by api docs now.
|
||
/* class to hold authentication metadata | ||
/** | ||
* @summary interface to hold authentication metadata |
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 don't think we are using @summary
anywhere else, what is the benefit of using it in this place?
packages/authentication/src/keys.ts
Outdated
// License text available at https://opensource.org/licenses/MIT | ||
|
||
/** | ||
* @summary namespace for constants and keys for authentication |
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.
Ditto - is @summary
necessary?
packages/context/src/binding.ts
Outdated
* Bind the key to a BindingProvider | ||
* Bind the key to a Provider class | ||
* | ||
* @param provider - the class constructor of a value provider |
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.
Please remove -
from between the parameter name and its description.
@param provider The class constructor of a value provider
* Bind the key to a Provider class | ||
* | ||
* @param provider - the class constructor of a value provider | ||
*/ |
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.
Can you please add an small code example showing a custom Provider class and how it is bound?
@deepakrkris ping |
Also improve api docs for context package.
cc @bajtos @raymondfeng @ritch @superkhau
Closes #370