Skip to content

Conversation

deepakrkris
Copy link
Contributor

@deepakrkris deepakrkris commented Jun 27, 2017

Copy link
Member

@bajtos bajtos left a 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
Copy link
Member

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?

// License text available at https://opensource.org/licenses/MIT

/**
* @summary namespace for constants and keys for authentication
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ditto - is @summary necessary?

* Bind the key to a BindingProvider
* Bind the key to a Provider class
*
* @param provider - the class constructor of a value provider
Copy link
Member

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
*/
Copy link
Member

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?

@bajtos
Copy link
Member

bajtos commented Jul 13, 2017

@deepakrkris ping

Also improve api docs for context package.
@bajtos bajtos self-assigned this Aug 4, 2017
@bajtos bajtos added this to the Sprint 41 - Asteroid milestone Aug 4, 2017
@bajtos bajtos merged commit 421b063 into master Aug 4, 2017
@bajtos bajtos deleted the authPkgJsDocs branch August 4, 2017 08:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants