docs: clarify how to choose between v3 and v2 variants of the API (#674)

googleapis · May 26, 2021 · 4f9782e · 4f9782e
1 parent 0f20512
commit 4f9782e
Show file tree

Hide file tree

Showing 2 changed files with 12 additions and 0 deletions.
diff --git a/packages/google-cloud-translate/.readme-partials.yml b/packages/google-cloud-translate/.readme-partials.yml
@@ -5,6 +5,12 @@ introduction: |-
   integrate with the translation service programmatically. The Cloud Translation
   API is part of the larger Cloud Machine Learning API family.
 samples_body: |-
+  ### Choosing between Advanced v3 and Basic v2
+
+  Basic supports language detection and text translation [Cloud Translation - Basic v2](https://cloud.google.com/translate/docs/editions#basic).
+
+  The advanced edition of [Cloud Translation - V3](https://cloud.google.com/translate/docs/editions#advanced) is optimized for customization and long form content use cases including glossary, batch, and model selection.
+
   ### Translate V3 Beta Samples
 
   #### Install Dependencies

diff --git a/packages/google-cloud-translate/samples/README.md b/packages/google-cloud-translate/samples/README.md
@@ -25,6 +25,12 @@ API is part of the larger Cloud Machine Learning API family.
 Before running the samples, make sure you've followed the steps outlined in
 [Using the client library](https://github.com/googleapis/nodejs-translate#using-the-client-library).
 
+### Choosing between Advanced v3 and Basic v2
+
+Basic supports language detection and text translation [Cloud Translation - Basic v2](https://cloud.google.com/translate/docs/editions#basic).
+
+The advanced edition of [Cloud Translation - V3](https://cloud.google.com/translate/docs/editions#advanced) is optimized for customization and long form content use cases including glossary, batch, and model selection.
+
 ### Translate V3 Beta Samples
 
 #### Install Dependencies