-
Notifications
You must be signed in to change notification settings - Fork 592
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
docs: jsdoc + travis auto build to gh-pages. #127
Conversation
Let me know if/when this is merge-worthy, and I'll do a rebase and rebuild of the docs so we're current. |
Oh, I thought it was still WIP from the commit message :) Looks good to me, please go forward. I'll then make some tweaks that we'll discuss later! |
cc6dfcc
to
d27dfad
Compare
Re-built :) |
Is it possible to remove TODOs and private types/members/methods from docs? We should generate docs only for user-facing stuff. |
Poll time! Do you think the docs should be: var dataset = new Dataset(){}; or a real use case: var gcloud = require('gcloud');
var dataset = new gcloud.datastore.Dataset({}); ? |
I vote real use case. |
I vote for the real use case too. Maybe we don't need to mention |
Holy moly, the big PR is updated! http://stephenplusplus.github.io/gcloud-node/ for a preview. |
Looks great! |
Great, thanks! |
docs: jsdoc + travis auto build to gh-pages.
chore(deps): update dependency mocha to v6 This PR contains the following updates: | Package | Type | Update | Change | References | |---|---|---|---|---| | mocha | devDependencies | major | `^5.2.0` -> `^6.0.0` | [homepage](https://mochajs.org/), [source](https://github.com/mochajs/mocha) | --- ### Release Notes <details> <summary>mochajs/mocha</summary> ### [`v6.0.0`](https://github.com/mochajs/mocha/blob/master/CHANGELOG.md#​600--2019-02-18) [Compare Source](https://github.com/mochajs/mocha/compare/v5.2.0...v6.0.0) #### 🎉 Enhancements - [#​3726](https://github.com/mochajs/mocha/issues/3726): Add ability to unload files from `require` cache ([**@​plroebuck**](https://github.com/plroebuck)) #### 🐛 Fixes - [#​3737](https://github.com/mochajs/mocha/issues/3737): Fix falsy values from options globals ([**@​plroebuck**](https://github.com/plroebuck)) - [#​3707](https://github.com/mochajs/mocha/issues/3707): Fix encapsulation issues for `Suite#_onlyTests` and `Suite#_onlySuites` ([**@​vkarpov15**](https://github.com/vkarpov15)) - [#​3711](https://github.com/mochajs/mocha/issues/3711): Fix diagnostic messages dealing with plurality and markup of output ([**@​plroebuck**](https://github.com/plroebuck)) - [#​3723](https://github.com/mochajs/mocha/issues/3723): Fix "reporter-option" to allow comma-separated options ([**@​boneskull**](https://github.com/boneskull)) - [#​3722](https://github.com/mochajs/mocha/issues/3722): Fix code quality and performance of `lookupFiles` and `files` ([**@​plroebuck**](https://github.com/plroebuck)) - [#​3650](https://github.com/mochajs/mocha/issues/3650), [#​3654](https://github.com/mochajs/mocha/issues/3654): Fix noisy error message when no files found ([**@​craigtaub**](https://github.com/craigtaub)) - [#​3632](https://github.com/mochajs/mocha/issues/3632): Tests having an empty title are no longer confused with the "root" suite ([**@​juergba**](https://github.com/juergba)) - [#​3666](https://github.com/mochajs/mocha/issues/3666): Fix missing error codes ([**@​vkarpov15**](https://github.com/vkarpov15)) - [#​3684](https://github.com/mochajs/mocha/issues/3684): Fix exiting problem in Node.js v11.7.0+ ([**@​addaleax**](https://github.com/addaleax)) - [#​3691](https://github.com/mochajs/mocha/issues/3691): Fix `--delay` (and other boolean options) not working in all cases ([**@​boneskull**](https://github.com/boneskull)) - [#​3692](https://github.com/mochajs/mocha/issues/3692): Fix invalid command-line argument usage not causing actual errors ([**@​boneskull**](https://github.com/boneskull)) - [#​3698](https://github.com/mochajs/mocha/issues/3698), [#​3699](https://github.com/mochajs/mocha/issues/3699): Fix debug-related Node.js options not working in all cases ([**@​boneskull**](https://github.com/boneskull)) - [#​3700](https://github.com/mochajs/mocha/issues/3700): Growl notifications now show the correct number of tests run ([**@​outsideris**](https://github.com/outsideris)) - [#​3686](https://github.com/mochajs/mocha/issues/3686): Avoid potential ReDoS when diffing large objects ([**@​cyjake**](https://github.com/cyjake)) - [#​3715](https://github.com/mochajs/mocha/issues/3715): Fix incorrect order of emitted events when used programmatically ([**@​boneskull**](https://github.com/boneskull)) - [#​3706](https://github.com/mochajs/mocha/issues/3706): Fix regression wherein `--reporter-option`/`--reporter-options` did not support comma-separated key/value pairs ([**@​boneskull**](https://github.com/boneskull)) #### 📖 Documentation - [#​3652](https://github.com/mochajs/mocha/issues/3652): Switch from Jekyll to Eleventy ([**@​Munter**](https://github.com/Munter)) #### 🔩 Other - [#​3677](https://github.com/mochajs/mocha/issues/3677): Add error objects for createUnsupportedError and createInvalidExceptionError ([**@​boneskull**](https://github.com/boneskull)) - [#​3733](https://github.com/mochajs/mocha/issues/3733): Removed unnecessary processing in post-processing hook ([**@​wanseob**](https://github.com/wanseob)) - [#​3730](https://github.com/mochajs/mocha/issues/3730): Update nyc to latest version ([**@​coreyfarrell**](https://github.com/coreyfarrell)) - [#​3648](https://github.com/mochajs/mocha/issues/3648), [#​3680](https://github.com/mochajs/mocha/issues/3680): Fixes to support latest versions of [unexpected](https://npm.im/unexpected) and [unexpected-sinon](https://npm.im/unexpected-sinon) ([**@​sunesimonsen**](https://github.com/sunesimonsen)) - [#​3638](https://github.com/mochajs/mocha/issues/3638): Add meta tag to site ([**@​MartijnCuppens**](https://github.com/MartijnCuppens)) - [#​3653](https://github.com/mochajs/mocha/issues/3653): Fix parts of test suite failing to run on Windows ([**@​boneskull**](https://github.com/boneskull)) </details> --- ### Renovate configuration :date: **Schedule**: "after 9am and before 3pm" (UTC). :vertical_traffic_light: **Automerge**: Disabled by config. Please merge this manually once you are satisfied. :recycle: **Rebasing**: Whenever PR is stale, or if you modify the PR title to begin with "`rebase!`". :no_bell: **Ignore**: Close this PR and you won't be reminded about this update again. --- - [ ] <!-- renovate-rebase -->If you want to rebase/retry this PR, check this box --- This PR has been generated by [Renovate Bot](https://github.com/marketplace/renovate). View repository job log [here](https://renovatebot.com/dashboard#googleapis/nodejs-kms). #127 automerged by dpebot
PiperOrigin-RevId: 377947699 Source-Link: googleapis/googleapis@90717db Source-Link: googleapis/googleapis-gen@a06347a
🤖 I have created a release \*beep\* \*boop\* --- ## [2.11.0](https://www.github.com/googleapis/nodejs-dialogflow-cx/compare/v2.10.0...v2.11.0) (2021-06-21) ### Features * **v3beta1:** Support partial response feature ([ee8a24a](https://www.github.com/googleapis/nodejs-dialogflow-cx/commit/ee8a24a1e47cb352198880490f047e2ff3d47152)) * **v3beta1:** support sentiment analysis in bot testing ([#127](https://www.github.com/googleapis/nodejs-dialogflow-cx/issues/127)) ([2c45b2c](https://www.github.com/googleapis/nodejs-dialogflow-cx/commit/2c45b2c4e9662aaef7352f3b3edf58c0bf29779e)) ### Bug Fixes * **v3beta1:** set agent default language code as required ([#134](https://www.github.com/googleapis/nodejs-dialogflow-cx/issues/134)) ([ee8a24a](https://www.github.com/googleapis/nodejs-dialogflow-cx/commit/ee8a24a1e47cb352198880490f047e2ff3d47152)) --- This PR was generated with [Release Please](https://github.com/googleapis/release-please). See [documentation](https://github.com/googleapis/release-please#release-please).
fix: use google-gax v3.3.0 Source-Link: googleapis/synthtool@c73d112 Post-Processor: gcr.io/cloud-devrel-public-resources/owlbot-nodejs:latest@sha256:b15a6f06cc06dcffa11e1bebdf1a74b6775a134aac24a0f86f51ddf728eb373e
#127) * build(node): add feat in node post-processor to add client library version number in snippet metadata Co-authored-by: Benjamin E. Coe <[email protected]> Source-Link: googleapis/synthtool@d337b88 Post-Processor: gcr.io/cloud-devrel-public-resources/owlbot-nodejs:latest@sha256:d106724ad2a96daa1b8d88de101ba50bdb30b8df62ffa0aa2b451d93b4556641
🤖 I have created a release *beep* *boop* --- ## [2.0.3](https://github.com/googleapis/nodejs-org-policy/compare/v2.0.2...v2.0.3) (2022-11-11) ### Bug Fixes * Allow passing gax instance to client constructor ([#126](https://github.com/googleapis/nodejs-org-policy/issues/126)) ([c7147d4](https://github.com/googleapis/nodejs-org-policy/commit/c7147d40a9ed114ec42997d49c2f5dfcff948aad)) * **deps:** Use google-gax v3.5.2 ([#134](https://github.com/googleapis/nodejs-org-policy/issues/134)) ([0f1bfb0](https://github.com/googleapis/nodejs-org-policy/commit/0f1bfb0007ade736c2ec91f32ff187c80b2d6761)) * Do not import the whole google-gax from proto JS ([#1553](https://github.com/googleapis/nodejs-org-policy/issues/1553)) ([#125](https://github.com/googleapis/nodejs-org-policy/issues/125)) ([068b0a5](https://github.com/googleapis/nodejs-org-policy/commit/068b0a55fe805cedab9e66f62071c8be56f465ed)) * Preserve default values in x-goog-request-params header ([#128](https://github.com/googleapis/nodejs-org-policy/issues/128)) ([3f80014](https://github.com/googleapis/nodejs-org-policy/commit/3f80014a3c75311555df6cfde8470ae1f72a686f)) * Regenerated protos JS and TS definitions ([#137](https://github.com/googleapis/nodejs-org-policy/issues/137)) ([1606459](https://github.com/googleapis/nodejs-org-policy/commit/1606459c847f2ed945dccc8e43d57d273fac7ea9)) * use google-gax v3.3.0 ([068b0a5](https://github.com/googleapis/nodejs-org-policy/commit/068b0a55fe805cedab9e66f62071c8be56f465ed)) --- This PR was generated with [Release Please](https://github.com/googleapis/release-please). See [documentation](https://github.com/googleapis/release-please#release-please).
[![WhiteSource Renovate](https://app.renovatebot.com/images/banner.svg)](https://renovatebot.com) This PR contains the following updates: | Package | Change | Age | Adoption | Passing | Confidence | |---|---|---|---|---|---| | [@types/mocha](https://github.com/DefinitelyTyped/DefinitelyTyped) | [`^8.0.4` -> `^9.0.0`](https://renovatebot.com/diffs/npm/@types%2fmocha/8.2.3/9.1.1) | [![age](https://badges.renovateapi.com/packages/npm/@types%2fmocha/9.1.1/age-slim)](https://docs.renovatebot.com/merge-confidence/) | [![adoption](https://badges.renovateapi.com/packages/npm/@types%2fmocha/9.1.1/adoption-slim)](https://docs.renovatebot.com/merge-confidence/) | [![passing](https://badges.renovateapi.com/packages/npm/@types%2fmocha/9.1.1/compatibility-slim/8.2.3)](https://docs.renovatebot.com/merge-confidence/) | [![confidence](https://badges.renovateapi.com/packages/npm/@types%2fmocha/9.1.1/confidence-slim/8.2.3)](https://docs.renovatebot.com/merge-confidence/) | --- ### Configuration 📅 **Schedule**: "after 9am and before 3pm" (UTC). 🚦 **Automerge**: Disabled by config. Please merge this manually once you are satisfied. ♻ **Rebasing**: Whenever PR is behind base branch, or you tick the rebase/retry checkbox. 🔕 **Ignore**: Close this PR and you won't be reminded about this update again. --- - [ ] <!-- rebase-check -->If you want to rebase/retry this PR, click this checkbox. --- This PR has been generated by [WhiteSource Renovate](https://renovate.whitesourcesoftware.com). View repository job log [here](https://app.renovatebot.com/dashboard#github/googleapis/nodejs-managed-identities).
* [CHANGE ME] Re-generated to pick up changes in the API or client library generator. * test: update sample test to pass Co-authored-by: Alexander Fenster <[email protected]>
Source-Link: googleapis/synthtool@6981da4 Post-Processor: gcr.io/cloud-devrel-public-resources/owlbot-nodejs:latest@sha256:3563b6b264989c4f5aa31a3682e4df36c95756cfef275d3201508947cbfc511e Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
This PR includes changes from googleapis/gapic-generator-typescript#317 that will move the asynchronous initialization and authentication from the client constructor to an `initialize()` method. This method will be automatically called when the first RPC call is performed. The client library usage has not changed, there is no need to update any code. If you want to make sure the client is authenticated _before_ the first RPC call, you can do ```js await client.initialize(); ``` manually before calling any client method.
🤖 I have created a release \*beep\* \*boop\* --- ## [1.8.0](https://www.github.com/googleapis/nodejs-datacatalog/compare/v1.7.0...v1.8.0) (2020-03-06) ### Features * deferred client initialization ([#127](https://www.github.com/googleapis/nodejs-datacatalog/issues/127)) ([1640d4d](https://www.github.com/googleapis/nodejs-datacatalog/commit/1640d4d8fe1a9adbff9719399e5e2fff95bbb4b5)) * export protos in src/index.ts ([86933a1](https://www.github.com/googleapis/nodejs-datacatalog/commit/86933a113549c33a5283e7bf438ce0229b74155b)) --- This PR was generated with [Release Please](https://github.com/googleapis/release-please).
work in progress
RE: #125
Preview:
JSDoc-rendered HTML: http://stephenplusplus.github.io/gcloud-node
Readme changes: https://github.com/stephenplusplus/gcloud-node/tree/docs