Update all Go snippet tags to include imports in the snippets.

Fix cut'n'paste error.

Normalize (mostly) the way snippets are included so they are consistent.

Remove missed snippet.

Update READMEs with WRITEME.

Author: Laren-AWS

.doc_gen/metadata/bedrock-runtime_metadata.yaml

@@ -555,6 +555,7 @@ bedrock-runtime_InvokeModel_Ai21LabsJurassic2:
           excerpts:
             - description: Use the Invoke Model API to send a text message.
               snippet_tags:
+                - gov2.bedrock-runtime.InvokeModelWrapper.struct
                 - gov2.bedrock-runtime.InvokeJurassic2
     JavaScript:
       versions:
@@ -620,6 +621,7 @@ bedrock-runtime_InvokeModel_TitanText:
           excerpts:
             - description: Use the Invoke Model API to send a text message.
               snippet_tags:
+                - gov2.bedrock-runtime.InvokeModelWrapper.struct
                 - gov2.bedrock-runtime.InvokeTitanText
   services:
     bedrock-runtime: {InvokeModel}
@@ -669,6 +671,7 @@ bedrock-runtime_InvokeModel_AnthropicClaude:
           excerpts:
             - description: Invoke the Anthropic Claude 2 foundation model to generate text.
               snippet_tags:
+                - gov2.bedrock-runtime.InvokeModelWrapper.struct
                 - gov2.bedrock-runtime.InvokeClaude
     PHP:
       versions:
@@ -799,6 +802,7 @@ bedrock-runtime_InvokeModel_MetaLlama2:
           excerpts:
             - description: Use the Invoke Model API to send a text message.
               snippet_tags:
+                - gov2.bedrock-runtime.InvokeModelWrapper.struct
                 - gov2.bedrock-runtime.InvokeLlama2
     JavaScript:
       versions:
@@ -972,6 +976,7 @@ bedrock-runtime_InvokeModelWithResponseStream_AnthropicClaude:
           excerpts:
             - description: Use the Invoke Model API to send a text message and process the response stream in real-time.
               snippet_tags:
+                - gov2.bedrock-runtime.InvokeModelWrapper.struct
                 - gov2.bedrock-runtime.InvokeModelWithResponseStream
     JavaScript:
       versions:
@@ -1195,6 +1200,7 @@ bedrock-runtime_InvokeModel_TitanImageGenerator:
           excerpts:
             - description: Create an image with the Amazon Titan Image Generator.
               snippet_tags:
+                - gov2.bedrock-runtime.InvokeModelWrapper.struct
                 - gov2.bedrock-runtime.InvokeTitanImage
     PHP:
       versions:

.doc_gen/metadata/dynamodb_metadata.yaml

@@ -394,6 +394,8 @@ dynamodb_BatchWriteItem:
               snippet_tags:
                 - gov2.dynamodb.TableBasics.struct
                 - gov2.dynamodb.BatchWriteItem
+            - description: Define a Movie struct that is used in this example.
+              snippet_tags:
                 - gov2.dynamodb.Movie.struct
     Java:
       versions:
@@ -643,6 +645,8 @@ dynamodb_PutItem:
               snippet_tags:
                 - gov2.dynamodb.TableBasics.struct
                 - gov2.dynamodb.PutItem
+            - description: Define a Movie struct that is used in this example.
+              snippet_tags:
                 - gov2.dynamodb.Movie.struct
     Kotlin:
       versions:
@@ -780,6 +784,8 @@ dynamodb_GetItem:
               snippet_tags:
                 - gov2.dynamodb.TableBasics.struct
                 - gov2.dynamodb.GetItem
+            - description: Define a Movie struct that is used in this example.
+              snippet_tags:
                 - gov2.dynamodb.Movie.struct
     Kotlin:
       versions:
@@ -908,6 +914,8 @@ dynamodb_UpdateItem:
               snippet_tags:
                 - gov2.dynamodb.TableBasics.struct
                 - gov2.dynamodb.UpdateItem
+            - description: Define a Movie struct that is used in this example.
+              snippet_tags:
                 - gov2.dynamodb.Movie.struct
     Kotlin:
       versions:
@@ -1024,6 +1032,8 @@ dynamodb_DeleteItem:
               snippet_tags:
                 - gov2.dynamodb.TableBasics.struct
                 - gov2.dynamodb.DeleteItem
+            - description: Define a Movie struct that is used in this example.
+              snippet_tags:
                 - gov2.dynamodb.Movie.struct
     Kotlin:
       versions:
@@ -1309,6 +1319,8 @@ dynamodb_Query:
               snippet_tags:
                 - gov2.dynamodb.TableBasics.struct
                 - gov2.dynamodb.Query
+            - description: Define a Movie struct that is used in this example.
+              snippet_tags:
                 - gov2.dynamodb.Movie.struct
     Kotlin:
       versions:
@@ -1448,6 +1460,8 @@ dynamodb_Scan:
               snippet_tags:
                 - gov2.dynamodb.TableBasics.struct
                 - gov2.dynamodb.Scan
+            - description: Define a Movie struct that is used in this example.
+              snippet_tags:
                 - gov2.dynamodb.Movie.struct
     Kotlin:
       versions:
@@ -1578,6 +1592,9 @@ dynamodb_ExecuteStatement:
         - sdk_version: 2
           github: gov2/dynamodb
           excerpts:
+            - description: Define a function receiver struct for the example.
+              snippet_tags:
+                - gov2.dynamodb.PartiQLRunner.struct
             - description: Use an INSERT statement to add an item.
               snippet_tags:
                 - gov2.dynamodb.ExecuteStatement.Insert
@@ -1699,6 +1716,9 @@ dynamodb_BatchExecuteStatement:
         - sdk_version: 2
           github: gov2/dynamodb
           excerpts:
+            - description: Define a function receiver struct for the example.
+              snippet_tags:
+                - gov2.dynamodb.PartiQLRunner.struct
             - description: Use batches of INSERT statements to add items.
               snippet_tags:
                 - gov2.dynamodb.BatchExecuteStatement.Insert

.doc_gen/metadata/lambda_metadata.yaml

@@ -794,9 +794,6 @@ lambda_Scenario_GettingStartedFunctions:
             - description: Create a struct that wraps individual &LAM; actions.
               snippet_tags:
                 - gov2.lambda.FunctionWrapper.complete
-            - description: Create a struct that implements functions to help run the scenario.
-              snippet_tags:
-                - gov2.lambda.GetStartedFunctions_Helper
             - description: Define a &LAM; handler that increments a number.
               snippet_tags:
                 - gov2.lambda.handlers.increment

.doc_gen/metadata/s3_metadata.yaml

@@ -2742,6 +2742,7 @@ s3_Scenario_PresignedUrl:
             - description: Run an interactive example that generates and uses presigned URLs to upload, download, and delete
                 an S3 object.
               snippet_tags:
+                - gov2.s3.Scenario_Presigning.imports
                 - gov2.s3.Scenario_Presigning
             - description: Define an HTTP request wrapper used by the example to make HTTP requests.
               snippet_tags:

.doc_gen/metadata/sqs_metadata.yaml

@@ -980,6 +980,9 @@ sqs_Scenario_TopicsAndQueues:
             - description: Define a struct that wraps &SQS; actions used in this example.
               snippet_tags:
                 - gov2.sqs.SqsActions.complete
+            - description: Clean up resources.
+              snippet_tags:
+                - gov2.workflows.TopicsAndQueues.Resources.complete
     JavaScript:
       versions:
         - sdk_version: 3

gov2/aurora/actions/clusters.go

@@ -2,6 +2,9 @@
 // SPDX-License-Identifier: Apache-2.0
 package actions
 
+// snippet-start:[gov2.aurora.DbClusters.complete]
+// snippet-start:[gov2.aurora.DbClusters.struct]
+
 import (
 	"context"
 	"errors"
@@ -12,9 +15,6 @@ import (
 	"github.com/aws/aws-sdk-go-v2/service/rds/types"
 )
 
-// snippet-start:[gov2.aurora.DbClusters.complete]
-// snippet-start:[gov2.aurora.DbClusters.struct]
-
 type DbClusters struct {
 	AuroraClient *rds.Client
 }

gov2/aurora/scenarios/get_started_clusters.go

@@ -3,6 +3,8 @@
 
 package scenarios
 
+// snippet-start:[gov2.aurora.Scenario_GetStartedClusters]
+
 import (
 	"aurora/actions"
 	"context"
@@ -21,26 +23,6 @@ import (
 	"github.com/google/uuid"
 )
 
-// IScenarioHelper abstracts the function from a scenario so that it
-// can be mocked for unit testing.
-type IScenarioHelper interface {
-	Pause(secs int)
-	UniqueId() string
-}
-type ScenarioHelper struct{}
-
-// Pause waits for the specified number of seconds.
-func (helper ScenarioHelper) Pause(secs int) {
-	time.Sleep(time.Duration(secs) * time.Second)
-}
-
-// UniqueId returns a new UUID.
-func (helper ScenarioHelper) UniqueId() string {
-	return uuid.New().String()
-}
-
-// snippet-start:[gov2.aurora.Scenario_GetStartedClusters]
-
 // GetStartedClusters is an interactive example that shows you how to use the AWS SDK for Go
 // with Amazon Aurora to do the following:
 //
@@ -384,4 +366,22 @@ func (scenario GetStartedClusters) Cleanup(ctx context.Context, dbInstance *type
 	}
 }
 
+// IScenarioHelper abstracts the function from a scenario so that it
+// can be mocked for unit testing.
+type IScenarioHelper interface {
+	Pause(secs int)
+	UniqueId() string
+}
+type ScenarioHelper struct{}
+
+// Pause waits for the specified number of seconds.
+func (helper ScenarioHelper) Pause(secs int) {
+	time.Sleep(time.Duration(secs) * time.Second)
+}
+
+// UniqueId returns a new UUID.
+func (helper ScenarioHelper) UniqueId() string {
+	return uuid.New().String()
+}
+
 // snippet-end:[gov2.aurora.Scenario_GetStartedClusters]

gov2/bedrock-runtime/README.md

@@ -42,24 +42,24 @@ functions within the same service.
 
 ### AI21 Labs Jurassic-2
 
-- [InvokeModel](actions/invoke_model.go#L83)
+- [InvokeModel](actions/invoke_model.go#L7)
 
 ### Amazon Titan Image Generator
 
-- [InvokeModel](actions/invoke_model.go#L191)
+- [InvokeModel](actions/invoke_model.go#L7)
 
 ### Amazon Titan Text
 
-- [InvokeModel](actions/invoke_model.go#L261)
+- [InvokeModel](actions/invoke_model.go#L7)
 
 ### Anthropic Claude
 
-- [InvokeModel](actions/invoke_model.go#L27)
+- [InvokeModel](actions/invoke_model.go#L7)
 - [InvokeModelWithResponseStream](actions/invoke_model_with_response_stream.go#L30)
 
 ### Meta Llama
 
-- [InvokeModel: Llama 2](actions/invoke_model.go#L140)
+- [InvokeModel: Llama 2](actions/invoke_model.go#L7)
 
 
 <!--custom.examples.start-->

gov2/bedrock-runtime/actions/invoke_model.go

@@ -3,6 +3,9 @@
 
 package actions
 
+// snippet-start:[gov2.bedrock-runtime.InvokeModelWrapper.complete]
+// snippet-start:[gov2.bedrock-runtime.InvokeModelWrapper.struct]
+
 import (
 	"context"
 	"encoding/json"
@@ -13,9 +16,6 @@ import (
 	"github.com/aws/aws-sdk-go-v2/service/bedrockruntime"
 )
 
-// snippet-start:[gov2.bedrock-runtime.InvokeModelWrapper.complete]
-// snippet-start:[gov2.bedrock-runtime.InvokeModelWrapper.struct]
-
 // InvokeModelWrapper encapsulates Amazon Bedrock actions used in the examples.
 // It contains a Bedrock Runtime client that is used to invoke foundation models.
 type InvokeModelWrapper struct {

gov2/bedrock-runtime/actions/invoke_model_with_response_stream.go

@@ -3,6 +3,9 @@
 
 package actions
 
+// snippet-start:[gov2.bedrock-runtime.InvokeModelWithResponseStreamWrapper.complete]
+// snippet-start:[gov2.bedrock-runtime.InvokeModelWithResponseStreamWrapper.struct]
+
 import (
 	"bytes"
 	"context"
@@ -16,9 +19,6 @@ import (
 	"github.com/aws/aws-sdk-go-v2/service/bedrockruntime/types"
 )
 
-// snippet-start:[gov2.bedrock-runtime.InvokeModelWithResponseStreamWrapper.complete]
-// snippet-start:[gov2.bedrock-runtime.InvokeModelWithResponseStreamWrapper.struct]
-
 // InvokeModelWithResponseStreamWrapper encapsulates Amazon Bedrock actions used in the examples.
 // It contains a Bedrock Runtime client that is used to invoke foundation models.
 type InvokeModelWithResponseStreamWrapper struct {