multiple repetitions in Google Cloud Vision API: Node.js Samples, broken markdown too

[davie-robertson]

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

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

A screenshot that you have tested with "Try this API".

N/A

Link to the code that reproduces this issue. A link to a public Github Repository or gist with a minimal reproduction.

https://github.com/googleapis/google-cloud-node/blob/e67caa6c09990a161a58f7bef7fa6481ddda1f97/packages/google-cloud-vision/samples/README.md

A step-by-step description of how to reproduce the issue, based on the linked reproduction.

1. look for sample code for using ImageAnnotator.safeSearchDetection in the Google Cloud Vision API: Node.js Samples
2. See a list of examples Samples Image_annotator.async_batch_annotate_files Image_annotator.async_batch_annotate_images Image_annotator.batch_annotate_files Image_annotator.batch_annotate_images Product_search.add_product_to_product_set Product_search.create_product Product_search.create_product_set Product_search.create_reference_image Product_search.delete_product Product_search.delete_product_set Product_search.delete_reference_image Product_search.get_product Product_search.get_product_set Product_search.get_reference_image Product_search.import_product_sets Product_search.list_product_sets Product_search.list_products Product_search.list_products_in_product_set Product_search.list_reference_images Product_search.purge_products Product_search.remove_product_from_product_set Product_search.update_product Product_search.update_product_set Image_annotator.batch_annotate_images Image_annotator.async_batch_annotate_files Image_annotator.batch_annotate_images Image_annotator.async_batch_annotate_files Image_annotator.batch_annotate_images Product_search.add_product_to_product_set Product_search.create_product Product_search.create_product_set Product_search.create_reference_image Product_search.delete_product Product_search.delete_product_set Product_search.delete_reference_image Product_search.get_product Product_search.get_product_set Product_search.get_reference_image Product_search.import_product_sets Product_search.list_product_sets Product_search.list_products Product_search.list_products_in_product_set Product_search.list_reference_images Product_search.remove_product_from_product_set Product_search.update_product Product_search.update_product_set Image_annotator.async_batch_annotate_files Image_annotator.async_batch_annotate_images Image_annotator.batch_annotate_files Image_annotator.batch_annotate_images Product_search.add_product_to_product_set Product_search.create_product Product_search.create_product_set Product_search.create_reference_image Product_search.delete_product Product_search.delete_product_set Product_search.delete_reference_image Product_search.get_product Product_search.get_product_set Product_search.get_reference_image Product_search.import_product_sets Product_search.list_product_sets Product_search.list_products Product_search.list_products_in_product_set Product_search.list_reference_images Product_search.purge_products Product_search.remove_product_from_product_set Product_search.update_product Product_search.update_product_set Quickstart
3. Click an examples thinking it will show the code, it doesn't
4. Scroll down the page once you realise the hyperlinks don't work
5. See repetition (3x?) of all the sample code
6. Notice that all the Image_annotator sample contain batch_annotate but many are not batch annotations

A clear and concise description of what the bug is, and what you expected to happen.

The generator for the README.md seem to be broken.

The Google Cloud Vision API: Node.js Samples page should contain a list of sample code snippets that the user can click on and view.

It seems that all the code samples for all the branches versions are being placed into the same readme file, without clearly indicating to the user what version the sample code is for.

A clear and concise description WHY you expect this behavior, i.e., was it a recent change, there is documentation that points to this behavior, etc. **

The README.md for code samples should be generated separately for each branch of code.

The ToC should link to code samples

I would have done a PR to fix this, but the code states:

[github-actions[bot]]

Issue was opened with an invalid reproduction link. Please make sure the repository is a valid, publicly-accessible github repository, and make sure the url is complete (example: https://github.com/googleapis/google-cloud-node)

[davie-robertson]

the link is to the code in github with the errors: https://github.com/googleapis/google-cloud-node/blob/e67caa6c09990a161a58f7bef7fa6481ddda1f97/packages/google-cloud-vision/samples/README.md

or here: https://github.com/googleapis/google-cloud-node/tree/e67caa6c09990a161a58f7bef7fa6481ddda1f97/packages/google-cloud-vision/samples