DOCSP-23284: [CSFLE] make language selection more prominent and make it apply to full project download (#1270)

Chris Cho · web-flow · commit 736e13decec9 · 2022-06-21T13:47:17.000-04:00
* fix tabgroup for sample project downloads in CSFLE Quick Start

* use the language selector

* update format

* add language to code blocks

* relocate tabs-selector directive

* update text

* tweaks
diff --git a/source/core/csfle/quick-start.txt b/source/core/csfle/quick-start.txt
@@ -46,13 +46,14 @@ Before You Get Started
 
 .. include:: /includes/set-up-section.rst
 
+.. include:: /includes/select-your-language.rst
+
 .. see:: Full Application
 
-   To see the complete code for the application you make in this guide,
-   select the tab corresponding to your programming language and follow
-   the provided link:
+   To view the complete runnable application code for this tutorial, go to the
+   following link:
 
-   .. tabs::
+   .. tabs-drivers::
 
       .. tab:: Java
          :tabid: java-sync
@@ -84,6 +85,8 @@ Before You Get Started
 Procedure
 ---------
 
+.. include:: /includes/tutorials/language-id.rst
+
 .. procedure::
    :style: normal
 
diff --git a/source/core/csfle/tutorials/aws/aws-automatic.txt b/source/core/csfle/tutorials/aws/aws-automatic.txt
@@ -32,13 +32,14 @@ Before You Get Started
 
 .. include:: /includes/fact-csfle-placeholder.rst
 
+.. include:: /includes/select-your-language.rst
+
 .. see:: Full Application
 
-   To see the complete code for the application you make in this guide,
-   select the tab corresponding to your programming language and follow
-   the provided link:
+   To view the complete runnable application code for this tutorial, go to the
+   following link:
 
-   .. tabs::
+   .. tabs-drivers::
 
       .. tab:: Java
          :tabid: java-sync
@@ -70,6 +71,8 @@ Before You Get Started
 Set Up the KMS
 --------------
 
+.. include:: /includes/tutorials/language-id.rst
+
 .. procedure::
    :style: normal
 
diff --git a/source/core/csfle/tutorials/azure/azure-automatic.txt b/source/core/csfle/tutorials/azure/azure-automatic.txt
@@ -31,13 +31,14 @@ Before You Get Started
 
 .. include:: /includes/fact-csfle-placeholder.rst
 
+.. include:: /includes/select-your-language.rst
+
 .. see:: Full Application
 
-   To see the complete code for the application you make in this guide,
-   select the tab corresponding to your programming language and follow
-   the provided link:
+   To view the complete runnable application code for this tutorial, go to the
+   following link:
 
-   .. tabs::
+   .. tabs-drivers::
 
       .. tab:: Java
          :tabid: java-sync
@@ -69,6 +70,8 @@ Before You Get Started
 Set Up the KMS
 --------------
 
+.. include:: /includes/tutorials/language-id.rst
+
 .. procedure::
    :style: normal
 
diff --git a/source/core/csfle/tutorials/gcp/gcp-automatic.txt b/source/core/csfle/tutorials/gcp/gcp-automatic.txt
@@ -30,13 +30,14 @@ Before You Get Started
 
 .. include:: /includes/fact-csfle-placeholder.rst
 
+.. include:: /includes/select-your-language.rst
+
 .. see:: Full Application
 
-   To see the complete code for the application you make in this guide,
-   select the tab corresponding to your programming language and follow
-   the provided link:
+   To view the complete runnable application code for this tutorial, go to the
+   following link:
 
-   .. tabs::
+   .. tabs-drivers::
 
       .. tab:: Java
          :tabid: java-sync
@@ -68,6 +69,8 @@ Before You Get Started
 Set Up the KMS
 --------------
 
+.. include:: /includes/tutorials/language-id.rst
+
 .. procedure::
    :style: normal
 
diff --git a/source/includes/quick-start/dek.rst b/source/includes/quick-start/dek.rst
@@ -13,8 +13,6 @@
       you are using the Local Key Provider, set the provider name to
       ``local``.
 
-      .. include:: /includes/tab-note.rst
-
       .. tabs-drivers::
 
          .. tab::
diff --git a/source/includes/select-your-language.rst b/source/includes/select-your-language.rst
@@ -0,0 +1,3 @@
+Select the programming language for which you want to see code examples for
+from the :guilabel:`Select your language` dropdown menu on the right side of
+the page.
diff --git a/source/includes/tutorials/automatic/aws/dek.rst b/source/includes/tutorials/automatic/aws/dek.rst
@@ -6,8 +6,6 @@
       Add the service account credentials to your CSFLE-enabled client
       code.
 
-      .. include:: /includes/tab-note.rst
-
       .. include:: /includes/tutorials/automatic/aws/iam-credentials-note.rst
 
       .. tabs-drivers::
diff --git a/source/includes/tutorials/automatic/azure/dek.rst b/source/includes/tutorials/automatic/azure/dek.rst
@@ -8,8 +8,6 @@
       Add the service account credentials to your CSFLE-enabled client
       code.
 
-      .. include:: /includes/tab-note.rst
-
       .. tip::
 
          You recorded your {+azure-kv+} credentials in the
diff --git a/source/includes/tutorials/automatic/gcp/dek.rst b/source/includes/tutorials/automatic/gcp/dek.rst
@@ -6,8 +6,6 @@
       Add the service account credentials to your CSFLE-enabled client
       code.
 
-      .. include:: /includes/tab-note.rst
-
       .. include:: /includes/tutorials/automatic/gcp/gcp-credentials-note.rst
 
       .. tabs-drivers::
diff --git a/source/includes/tutorials/language-id.rst b/source/includes/tutorials/language-id.rst
@@ -0,0 +1,42 @@
+.. tabs-drivers::
+
+   .. tab::
+      :tabid: java-sync
+
+      .. code-block:: java
+
+         // You are viewing the Java synchronous driver code examples.
+         // Use the dropdown menu to select a different driver.
+
+   .. tab::
+      :tabid: nodejs
+
+      .. code-block:: javascript
+
+         // You are viewing the Node.js driver code examples.
+         // Use the dropdown menu to select a different driver.
+
+   .. tab::
+      :tabid: python
+
+      .. code-block:: python
+
+         # You are viewing the Python driver code examples.
+         # Use the dropdown menu to select a different driver.
+
+   .. tab::
+      :tabid: csharp
+
+      .. code-block:: csharp
+
+         // You are viewing the C# driver code examples.
+         // Use the dropdown menu to select a different driver.
+
+   .. tab::
+      :tabid: go
+
+      .. code-block:: go
+
+         // You are viewing the Golang driver code examples.
+         // Use the dropdown menu to select a different driver.
+

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+Select the programming language for which you want to see code examples for`
	`2`	+from the :guilabel:`Select your language` dropdown menu on the right side of
	`3`	`+the page.`