Skip to content

Conversation

@egilmorez
Copy link
Contributor

Adding TypeDoc comments for Auth methods, along with related TOC tweaks.

Staged internally at: https://firebase.devsite.corp.google.com/docs/reference/admin/node/admin.auth.Auth

Thanks!


/**
* Returns a JSON-serializable representation of this object.
*/
Copy link
Contributor

Choose a reason for hiding this comment

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

This should have an @return


/**
* Returns a JSON-serializable representation of this object.
*/
Copy link
Contributor

Choose a reason for hiding this comment

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

This should have an @return


/**
* Returns a JSON-serializable representation of this object.
*/
Copy link
Contributor

Choose a reason for hiding this comment

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

This should have an @return


/**
* Returns a JSON-serializable representation of this object.
*/
Copy link
Contributor

Choose a reason for hiding this comment

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

This should have an @return

src/index.d.ts Outdated
displayName?: string;

/**
* The user's primary phone number, if set..
Copy link
Contributor

Choose a reason for hiding this comment

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

Extra dot at the end.

src/index.d.ts Outdated
callbackURL?: string;

/**
*
Copy link
Contributor

Choose a reason for hiding this comment

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

Same here. I think we can remove this property enableRequestSigning

src/index.d.ts Outdated
* samples and detailed documentation.
*
* @param properties The properties to set on the
* new user record to be created.
Copy link
Contributor

Choose a reason for hiding this comment

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

fix second line indentation. Note some of these multi-line descriptions can be fit on the same line.

src/index.d.ts Outdated
*
* @param uid The `uid` corresponding to the user to delete.
* @param properties The properties to update on
* the provided user.
Copy link
Contributor

Choose a reason for hiding this comment

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

fix indentation

src/index.d.ts Outdated
* see the [GCIP documentation](https://cloud.google.com/identity-cp).
*
* @param options The provider config
* filter to apply.
Copy link
Contributor

Choose a reason for hiding this comment

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

move to previous line

src/index.d.ts Outdated
*
* @param options The provider config
* filter to apply.
* @return A promise that
Copy link
Contributor

Choose a reason for hiding this comment

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

Next line can probably fit on this line

src/index.d.ts Outdated
type UpdateAuthProviderRequest =
admin.auth.SAMLUpdateAuthProviderRequest | admin.auth.OIDCUpdateAuthProviderRequest;

Copy link
Contributor

Choose a reason for hiding this comment

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

I meant the spaces on line 1250

src/index.d.ts Outdated
* and accepts the Firebase Dynamic Links terms of service.
* The Android package name and iOS bundle ID are respected only if they
* are configured in the same Firebase Auth project.
* @return
Copy link
Contributor

Choose a reason for hiding this comment

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

You can safely add my suggestion here:
@return A promise that resolves with the generated link.

src/index.d.ts Outdated
/**
* Defines the dynamic link domain to use for the current link if it is to be
* opened using Firebase Dynamic Links, as multiple dynamic link domains can be
* configured per project. This field provides the ability explicitly choose
Copy link
Contributor

Choose a reason for hiding this comment

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

This fields provides the ability to explicitly choose...

@egilmorez egilmorez merged commit 9fe5c26 into hkj-typedoc May 23, 2019
hiranya911 pushed a commit that referenced this pull request Jun 5, 2019
* Adding commenting for Admin and Storage.

* Addressing feedback from hiranya911.

* Adding commenting for admin.Messaging and others.

* Fixing some issues found by hiranya911.

* Adding correct indenting in line 1909.

* Adding commmenting for admin.Auth classes and fleshing out TOC.

* Making fixes requeted by bojeil-google.

* Fixing one last alignment issue.

* Adding comments for Auth methods.

* Addressing feedback from bojeil-goole.

* Second attempt to view and address *all* comments from bojeil-google.

* Removing unnecessary whitespace.

* Fixing what we think and hope is the last typo in this pull request.
egilmorez added a commit that referenced this pull request Jun 5, 2019
* Getting the typedoc toolchain to run against index.d.ts

* Removing unused templates

* Adding a npm script

* Adding commenting for Admin and Storage. (#510)

* Adding commenting for Admin and Storage.

* Addressing feedback from hiranya911.

* Adding comments for admin.Messaging and a few others. (#516)

* Adding commenting for Admin and Storage.

* Addressing feedback from hiranya911.

* Adding commenting for admin.Messaging and others.

* Fixing some issues found by hiranya911.

* Adding correct indenting in line 1909.

* Auto-generating links to re-exported Firestore types (#519)

* Adding comments for Auth classes and updating TOC (#521)

* Adding commenting for Admin and Storage.

* Addressing feedback from hiranya911.

* Adding commenting for admin.Messaging and others.

* Fixing some issues found by hiranya911.

* Adding correct indenting in line 1909.

* Adding commmenting for admin.Auth classes and fleshing out TOC.

* Making fixes requeted by bojeil-google.

* Fixing one last alignment issue.

* Adding TypeDoc comments for Auth methods. (#530)

* Adding commenting for Admin and Storage.

* Addressing feedback from hiranya911.

* Adding commenting for admin.Messaging and others.

* Fixing some issues found by hiranya911.

* Adding correct indenting in line 1909.

* Adding commmenting for admin.Auth classes and fleshing out TOC.

* Making fixes requeted by bojeil-google.

* Fixing one last alignment issue.

* Adding comments for Auth methods.

* Addressing feedback from bojeil-goole.

* Second attempt to view and address *all* comments from bojeil-google.

* Removing unnecessary whitespace.

* Fixing what we think and hope is the last typo in this pull request.

* Credential db (#544)

* Adding comments for credential and database classes/methods.

* Fixing typo in example.

* Adding changes requested by hiranya911.

* Fixing a typo.

* Fixing the typo fixes.

* Adding comments for admin.projectManagement. (#547)

* Adding comments for admin.projectManagement.

* Fixing misplaced comments for appId metadata.

* Merging changes with master. (#553)

* Getting the typedoc toolchain to run against index.d.ts

* Removing unused templates

* Adding a npm script

* Adding commenting for Admin and Storage. (#510)

* Adding commenting for Admin and Storage.

* Addressing feedback from hiranya911.

* Adding comments for admin.Messaging and a few others. (#516)

* Adding commenting for Admin and Storage.

* Addressing feedback from hiranya911.

* Adding commenting for admin.Messaging and others.

* Fixing some issues found by hiranya911.

* Adding correct indenting in line 1909.

* Auto-generating links to re-exported Firestore types (#519)

* Adding comments for Auth classes and updating TOC (#521)

* Adding commenting for Admin and Storage.

* Addressing feedback from hiranya911.

* Adding commenting for admin.Messaging and others.

* Fixing some issues found by hiranya911.

* Adding correct indenting in line 1909.

* Adding commmenting for admin.Auth classes and fleshing out TOC.

* Making fixes requeted by bojeil-google.

* Fixing one last alignment issue.

* Adding TypeDoc comments for Auth methods. (#530)

* Adding commenting for Admin and Storage.

* Addressing feedback from hiranya911.

* Adding commenting for admin.Messaging and others.

* Fixing some issues found by hiranya911.

* Adding correct indenting in line 1909.

* Adding commmenting for admin.Auth classes and fleshing out TOC.

* Making fixes requeted by bojeil-google.

* Fixing one last alignment issue.

* Adding comments for Auth methods.

* Addressing feedback from bojeil-goole.

* Second attempt to view and address *all* comments from bojeil-google.

* Removing unnecessary whitespace.

* Fixing what we think and hope is the last typo in this pull request.

* Credential db (#544)

* Adding comments for credential and database classes/methods.

* Fixing typo in example.

* Adding changes requested by hiranya911.

* Fixing a typo.

* Fixing the typo fixes.

* Adding comments for admin.projectManagement. (#547)

* Adding comments for admin.projectManagement.

* Fixing misplaced comments for appId metadata.

* Adding new line to end of file.
@hiranya911 hiranya911 deleted the egilmore-typedoc-src branch May 18, 2021 18:45
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