Skip to content
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

fix(cloud-rad): move comments for TSDoc #1040

Merged
merged 1 commit into from Nov 6, 2021
Merged

Conversation

fhinkel
Copy link
Contributor

@fhinkel fhinkel commented Nov 5, 2021

As we move our ref docs to cloud.google.com, we rely on TSDoc rather JSDoc.

TSDoc expects comments before the first overloaded function, we
currently have those on the last function. Those comments don't make
it into the d.ts files. We need to move comments to the first
overloaded function rather than the last one.

Internally b/190631834

Script used: https://github.com/fhinkel/cloud-rad-script/blob/main/moveComments.js

@fhinkel fhinkel requested a review from a team November 5, 2021 23:22
@fhinkel fhinkel requested a review from a team as a code owner November 5, 2021 23:22
@product-auto-label product-auto-label bot added the api: bigquery Issues related to the googleapis/nodejs-bigquery API. label Nov 5, 2021
@google-cla google-cla bot added the cla: yes This human has signed the Contributor License Agreement. label Nov 5, 2021
Copy link
Member

@alexander-fenster alexander-fenster left a comment

Choose a reason for hiding this comment

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

I think fix might fit better than chore here.

As we move our ref docs to cloud.google.com, we rely on TSDoc rather JSDoc.

TSDoc expects comments before the first overloaded function, we
currently have those on the last function. Those comments don't make
it into the d.ts files. We need to move comments to the first
overloaded function rather than the last one.

Internally b/190631834

Script used: https://github.com/fhinkel/cloud-rad-script/blob/main/moveComments.js
@fhinkel fhinkel changed the title chore(cloud-rad): move comments for TSDoc fix(cloud-rad): move comments for TSDoc Nov 6, 2021
@fhinkel fhinkel merged commit 93c5e14 into main Nov 6, 2021
@fhinkel fhinkel deleted the fhinkel-move-comments branch November 6, 2021 00:05
gcf-merge-on-green bot pushed a commit that referenced this pull request Nov 16, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
api: bigquery Issues related to the googleapis/nodejs-bigquery API. cla: yes This human has signed the Contributor License Agreement.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

3 participants