updated Readmes

Author: scmacdon

cpp/example_code/lambda/README.md

@@ -42,6 +42,13 @@ Next, for information on code example structures and how to build and run the ex
 - [Hello Lambda](hello_lambda/CMakeLists.txt#L4) (`ListFunctions`)
 
 
+### Basics
+
+Code examples that show you how to perform the essential operations within a service.
+
+- [Learn the basics](get_started_with_functions_scenario.cpp)
+
+
 ### Single actions
 
 Code excerpts that show you how to call individual service functions.
@@ -60,7 +67,6 @@ Code examples that show you how to accomplish a specific task by calling multipl
 functions within the same service.
 
 - [Create a serverless application to manage photos](../../example_code/cross-service/photo_asset_manager)
-- [Get started with functions](get_started_with_functions_scenario.cpp)
 
 
 <!--custom.examples.start-->
@@ -91,35 +97,35 @@ folder.
 This example shows you how to get started using Lambda.
 
 
+#### Learn the basics
 
-#### Create a serverless application to manage photos
+This example shows you how to do the following:
 
-This example shows you how to create a serverless application that lets users manage photos using labels.
+- Create an IAM role and Lambda function, then upload handler code.
+- Invoke the function with a single parameter and get results.
+- Update the function code and configure with an environment variable.
+- Invoke the function with new parameters and get results. Display the returned execution log.
+- List the functions for your account, then clean up resources.
 
+<!--custom.basic_prereqs.lambda_Scenario_GettingStartedFunctions.start-->
+<!--custom.basic_prereqs.lambda_Scenario_GettingStartedFunctions.end-->
 
-<!--custom.scenario_prereqs.cross_PAM.start-->
-<!--custom.scenario_prereqs.cross_PAM.end-->
 
+<!--custom.basics.lambda_Scenario_GettingStartedFunctions.start-->
+<!--custom.basics.lambda_Scenario_GettingStartedFunctions.end-->
 
-<!--custom.scenarios.cross_PAM.start-->
-<!--custom.scenarios.cross_PAM.end-->
 
-#### Get started with functions
+#### Create a serverless application to manage photos
 
-This example shows you how to do the following:
+This example shows you how to create a serverless application that lets users manage photos using labels.
 
-- Create an IAM role and Lambda function, then upload handler code.
-- Invoke the function with a single parameter and get results.
-- Update the function code and configure with an environment variable.
-- Invoke the function with new parameters and get results. Display the returned execution log.
-- List the functions for your account, then clean up resources.
 
-<!--custom.scenario_prereqs.lambda_Scenario_GettingStartedFunctions.start-->
-<!--custom.scenario_prereqs.lambda_Scenario_GettingStartedFunctions.end-->
+<!--custom.scenario_prereqs.cross_PAM.start-->
+<!--custom.scenario_prereqs.cross_PAM.end-->
 
 
-<!--custom.scenarios.lambda_Scenario_GettingStartedFunctions.start-->
-<!--custom.scenarios.lambda_Scenario_GettingStartedFunctions.end-->
+<!--custom.scenarios.cross_PAM.start-->
+<!--custom.scenarios.cross_PAM.end-->
 
 ### Tests
 

dotnetv3/Lambda/README.md

@@ -34,6 +34,13 @@ For prerequisites, see the [README](../README.md#Prerequisites) in the `dotnetv3
 - [Hello Lambda](Actions/HelloLambda.cs#L4) (`ListFunctions`)
 
 
+### Basics
+
+Code examples that show you how to perform the essential operations within a service.
+
+- [Learn the basics](Actions/LambdaWrapper.cs)
+
+
 ### Single actions
 
 Code excerpts that show you how to call individual service functions.
@@ -53,7 +60,6 @@ functions within the same service.
 
 - [Create a serverless application to manage photos](../cross-service/PhotoAssetManager)
 - [Create an application to analyze customer feedback](../cross-service/FeedbackSentimentAnalyzer)
-- [Get started with functions](Actions/LambdaWrapper.cs)
 - [Transform data with S3 Object Lambda](../cross-service/S3ObjectLambdaFunction)
 
 
@@ -90,6 +96,23 @@ Alternatively, you can run the example from within your IDE.
 This example shows you how to get started using Lambda.
 
 
+#### Learn the basics
+
+This example shows you how to do the following:
+
+- Create an IAM role and Lambda function, then upload handler code.
+- Invoke the function with a single parameter and get results.
+- Update the function code and configure with an environment variable.
+- Invoke the function with new parameters and get results. Display the returned execution log.
+- List the functions for your account, then clean up resources.
+
+<!--custom.basic_prereqs.lambda_Scenario_GettingStartedFunctions.start-->
+<!--custom.basic_prereqs.lambda_Scenario_GettingStartedFunctions.end-->
+
+
+<!--custom.basics.lambda_Scenario_GettingStartedFunctions.start-->
+<!--custom.basics.lambda_Scenario_GettingStartedFunctions.end-->
+
 
 #### Create a serverless application to manage photos
 
@@ -115,42 +138,6 @@ This example shows you how to create an application that analyzes customer comme
 <!--custom.scenarios.cross_FSA.start-->
 <!--custom.scenarios.cross_FSA.end-->
 
-#### Get started with functions
-
-This example shows you how to do the following:
-
-- Create an IAM role and Lambda function, then upload handler code.
-- Invoke the function with a single parameter and get results.
-- Update the function code and configure with an environment variable.
-- Invoke the function with new parameters and get results. Display the returned execution log.
-- List the functions for your account, then clean up resources.
-
-<!--custom.scenario_prereqs.lambda_Scenario_GettingStartedFunctions.start-->
-<!--custom.scenario_prereqs.lambda_Scenario_GettingStartedFunctions.end-->
-
-
-<!--custom.scenarios.lambda_Scenario_GettingStartedFunctions.start-->
-Before you can run the getting started with Lambda scenario, you must upload
-the following two files to an Amazon Simple Storage Service (Amazon S3) bucket that you
-own:
-
- * [LambdaIncrement.zip](LambdaIncrement.zip)
- * [LambdaCalculator.zip](LambdaCalculator.zip)
- 
-##### Configuration settings
-
-The scenario includes the following settings in `settings.json`:
-
- * `FunctionName` - A name for the Lambda function.
- * `Handler` - "LambdaIncrement::LambdaIncrement.Function::FunctionHandler"
- * `UpdatedHandler` - "LambdaCalculator::LambdaCalculator.Function::FunctionHandler"
- * `BucketName` - The name of the bucket containing the .zip files for the sample functions.
- * `IncrementKey` - "LambdaIncrement.zip",
- * `CalculatorKey` - "LambdaCalculator.zip",
- * `RoleName` - The name of the IAM role that gives the scenario permissions to access Lambda.
- * `PolicyArn` - The Amazon Resource Name (ARN) of a policy giving the IAM role permissions to access Lambda.
-<!--custom.scenarios.lambda_Scenario_GettingStartedFunctions.end-->
-
 #### Transform data with S3 Object Lambda
 
 This example shows you how to transform data for your application with S3 Object Lambda.

gov2/lambda/README.md

@@ -34,6 +34,13 @@ For prerequisites, see the [README](../README.md#Prerequisites) in the `gov2` fo
 - [Hello Lambda](hello/hello.go#L4) (`ListFunctions`)
 
 
+### Basics
+
+Code examples that show you how to perform the essential operations within a service.
+
+- [Learn the basics](scenarios/scenario_get_started_functions.go)
+
+
 ### Single actions
 
 Code excerpts that show you how to call individual service functions.
@@ -53,7 +60,6 @@ functions within the same service.
 
 - [Automatically confirm known users with a Lambda function](../workflows/user_pools_and_lambda_triggers/workflows/scenario_auto_confirm_trusted_accounts.go)
 - [Automatically migrate known users with a Lambda function](../workflows/user_pools_and_lambda_triggers/workflows/scenario_migrate_user.go)
-- [Get started with functions](scenarios/scenario_get_started_functions.go)
 - [Write custom activity data with a Lambda function after Amazon Cognito user authentication](../workflows/user_pools_and_lambda_triggers/workflows/scenario_activity_log.go)
 
 
@@ -84,6 +90,23 @@ and to get help for running a scenario, use the following command:
 ```
 go run ./cmd -h
 ```
+#### Learn the basics
+
+This example shows you how to do the following:
+
+- Create an IAM role and Lambda function, then upload handler code.
+- Invoke the function with a single parameter and get results.
+- Update the function code and configure with an environment variable.
+- Invoke the function with new parameters and get results. Display the returned execution log.
+- List the functions for your account, then clean up resources.
+
+<!--custom.basic_prereqs.lambda_Scenario_GettingStartedFunctions.start-->
+<!--custom.basic_prereqs.lambda_Scenario_GettingStartedFunctions.end-->
+
+
+<!--custom.basics.lambda_Scenario_GettingStartedFunctions.start-->
+<!--custom.basics.lambda_Scenario_GettingStartedFunctions.end-->
+
 
 #### Automatically confirm known users with a Lambda function
 
@@ -118,23 +141,6 @@ This example shows you how to automatically migrate known Amazon Cognito users w
 <!--custom.scenarios.cross_CognitoAutoMigrateUser.start-->
 <!--custom.scenarios.cross_CognitoAutoMigrateUser.end-->
 
-#### Get started with functions
-
-This example shows you how to do the following:
-
-- Create an IAM role and Lambda function, then upload handler code.
-- Invoke the function with a single parameter and get results.
-- Update the function code and configure with an environment variable.
-- Invoke the function with new parameters and get results. Display the returned execution log.
-- List the functions for your account, then clean up resources.
-
-<!--custom.scenario_prereqs.lambda_Scenario_GettingStartedFunctions.start-->
-<!--custom.scenario_prereqs.lambda_Scenario_GettingStartedFunctions.end-->
-
-
-<!--custom.scenarios.lambda_Scenario_GettingStartedFunctions.start-->
-<!--custom.scenarios.lambda_Scenario_GettingStartedFunctions.end-->
-
 #### Write custom activity data with a Lambda function after Amazon Cognito user authentication
 
 This example shows you how to write custom activity data with a Lambda function after Amazon Cognito user authentication.

javascriptv3/example_code/lambda/README.md

@@ -34,6 +34,13 @@ For prerequisites, see the [README](../../README.md#Prerequisites) in the `javas
 - [Hello Lambda](hello.js#L6) (`ListFunctions`)
 
 
+### Basics
+
+Code examples that show you how to perform the essential operations within a service.
+
+- [Learn the basics](../iam/actions/attach-role-policy.js)
+
+
 ### Single actions
 
 Code excerpts that show you how to call individual service functions.
@@ -46,13 +53,6 @@ Code excerpts that show you how to call individual service functions.
 - [UpdateFunctionCode](actions/update-function-code.js#L15)
 - [UpdateFunctionConfiguration](actions/update-function-configuration.js#L12)
 
-### Scenarios
-
-Code examples that show you how to accomplish a specific task by calling multiple
-functions within the same service.
-
-- [Get started with functions](../iam/actions/attach-role-policy.js)
-
 
 <!--custom.examples.start-->
 <!--custom.examples.end-->
@@ -98,8 +98,7 @@ This example shows you how to get started using Lambda.
 node ./hello.js
 ```
 
-
-#### Get started with functions
+#### Learn the basics
 
 This example shows you how to do the following:
 
@@ -109,12 +108,13 @@ This example shows you how to do the following:
 - Invoke the function with new parameters and get results. Display the returned execution log.
 - List the functions for your account, then clean up resources.
 
-<!--custom.scenario_prereqs.lambda_Scenario_GettingStartedFunctions.start-->
-<!--custom.scenario_prereqs.lambda_Scenario_GettingStartedFunctions.end-->
+<!--custom.basic_prereqs.lambda_Scenario_GettingStartedFunctions.start-->
+<!--custom.basic_prereqs.lambda_Scenario_GettingStartedFunctions.end-->
+
 
+<!--custom.basics.lambda_Scenario_GettingStartedFunctions.start-->
+<!--custom.basics.lambda_Scenario_GettingStartedFunctions.end-->
 
-<!--custom.scenarios.lambda_Scenario_GettingStartedFunctions.start-->
-<!--custom.scenarios.lambda_Scenario_GettingStartedFunctions.end-->
 
 ### Tests
 

kotlin/services/lambda/README.md

@@ -29,6 +29,13 @@ For prerequisites, see the [README](../../README.md#Prerequisites) in the `kotli
 <!--custom.prerequisites.start-->
 <!--custom.prerequisites.end-->
 
+### Basics
+
+Code examples that show you how to perform the essential operations within a service.
+
+- [Learn the basics](src/main/kotlin/com/kotlin/lambda/LambdaScenario.kt)
+
+
 ### Single actions
 
 Code excerpts that show you how to call individual service functions.
@@ -37,13 +44,6 @@ Code excerpts that show you how to call individual service functions.
 - [DeleteFunction](src/main/kotlin/com/kotlin/lambda/DeleteFunction.kt#L38)
 - [Invoke](src/main/kotlin/com/kotlin/lambda/LambdaInvoke.kt#L39)
 
-### Scenarios
-
-Code examples that show you how to accomplish a specific task by calling multiple
-functions within the same service.
-
-- [Get started with functions](src/main/kotlin/com/kotlin/lambda/LambdaScenario.kt)
-
 
 <!--custom.examples.start-->
 <!--custom.examples.end-->
@@ -57,8 +57,7 @@ functions within the same service.
 <!--custom.instructions.end-->
 
 
-
-#### Get started with functions
+#### Learn the basics
 
 This example shows you how to do the following:
 
@@ -68,12 +67,13 @@ This example shows you how to do the following:
 - Invoke the function with new parameters and get results. Display the returned execution log.
 - List the functions for your account, then clean up resources.
 
-<!--custom.scenario_prereqs.lambda_Scenario_GettingStartedFunctions.start-->
-<!--custom.scenario_prereqs.lambda_Scenario_GettingStartedFunctions.end-->
+<!--custom.basic_prereqs.lambda_Scenario_GettingStartedFunctions.start-->
+<!--custom.basic_prereqs.lambda_Scenario_GettingStartedFunctions.end-->
+
 
+<!--custom.basics.lambda_Scenario_GettingStartedFunctions.start-->
+<!--custom.basics.lambda_Scenario_GettingStartedFunctions.end-->
 
-<!--custom.scenarios.lambda_Scenario_GettingStartedFunctions.start-->
-<!--custom.scenarios.lambda_Scenario_GettingStartedFunctions.end-->
 
 ### Tests