Docs are so out of date.

[StephenHodgson]

Please make sure you have searched for information in the following guides.

• Search the issues already opened: https://github.com/GoogleCloudPlatform/google-cloud-node/issues
• Check our Troubleshooting guide: https://googlecloudplatform.github.io/google-cloud-node/#/docs/guides/troubleshooting
• Check our FAQ: https://googlecloudplatform.github.io/google-cloud-node/#/docs/guides/faq
• Check our libraries HOW-TO: https://github.com/googleapis/gax-nodejs/blob/main/client-libraries.md
• Check out our authentication guide: https://github.com/googleapis/google-auth-library-nodejs
• Check out handwritten samples for many of our APIs: https://github.com/GoogleCloudPlatform/nodejs-docs-samples

Documentation Request

None of the docs are up to date. Last docs version is 147.0.0 latest version is 166.0.0

[quirogas]

Hi @StephenHodgson, thank you for filing this issue. Could you please provide a link to the site where you are referencing the documentation?

[StephenHodgson]

@quirogas all the docs.

• readme
• client-libraries
• docs-website

Most of the examples and samples have obsolete or deprecated usages that aren't anywhere close to what the latest version requires for usages and type definitions.

[quirogas]

@StephenHodgson, thank you for clarifying.

internal issue: b/454039544

[babelshift]

Is this library abandoned? Hundreds of GitHub Issues with no responses and documentation/samples that are years out of date. Is there an alternative library that should be used instead?

Examples:

• https://docs.cloud.google.com/nodejs/docs/reference has no information on using Business Profile APIs (https://developers.google.com/my-business/ref_overview) even though such functionality does exist in the library.
• Client library authentication documentation (https://docs.cloud.google.com/docs/authentication/client-libraries) contains bare minimum examples, is missing some authentication scenarios, and references code that is no longer valid.
• This library contains authentication classes and methods, but many of them are marked as deprecated and have comments that you should instead use the "google-auth-library" package, but samples and docs don't explain anything about that?
• The authentication section in the readme instructs to use deprecated functionality: https://docs.cloud.google.com/docs/authentication/client-libraries

I suggest Google use a portion of its $100 billion quarterly revenue to update its documentation.

[StephenHodgson]

$100 billion

I think the shareholders would take offense to this