Address PR review comments: fix service naming, remove duplicates, improve clarity

- Use 'Lambda durable functions' (lowercase) throughout
- Use full AWS service names (Amazon API Gateway, Amazon DynamoDB, Amazon SNS)
- Update regional availability note to be future-proof
- Remove duplicate monitoring sections
- Remove unnecessary DynamoDB monitoring section
- Make deployment instructions less prescriptive
- Rewrite bullet points as full sentences
- Add explanation for dual timeout configuration
- Update LinkedIn format to username only

Author: agawanea

lambda-durable-human-approval-sam/README.md

@@ -1,22 +1,22 @@
-# Human-in-the-Loop Approval Workflow with Lambda Durable Functions
+# Human-in-the-Loop Approval Workflow with AWS Lambda durable functions
 
-This pattern demonstrates a human-in-the-loop approval workflow using AWS Lambda Durable Functions. The workflow pauses execution for up to 24 hours while waiting for human approval via email, automatically handling timeouts and resuming when decisions are received.
+This pattern demonstrates a human-in-the-loop approval workflow using AWS Lambda durable functions. The workflow pauses execution for up to 24 hours while waiting for human approval via email, automatically handling timeouts and resuming when decisions are received.
 
-**Important:** Lambda Durable Functions are currently available in the **us-east-2 (Ohio)** region only.
+**Important:** Lambda durable functions have limited regional availability. Please check the [AWS documentation](https://docs.aws.amazon.com/lambda/latest/dg/durable-functions.html) for current regional support.
 
 Learn more about this pattern at Serverless Land Patterns: https://serverlessland.com/patterns/lambda-durable-hitl-approval-sam
 
 ## Architecture
 
 ![Architecture Diagram](architecture.png)
 
-The pattern uses Lambda Durable Functions to implement a cost-effective approval workflow that can wait up to 24 hours without incurring compute charges during the wait period.
+The pattern uses Lambda durable functions to implement a cost-effective approval workflow that can wait up to 24 hours without incurring compute charges during the wait period.
 
 ### Workflow Steps
 
-1. **User submits approval request** via API Gateway
+1. **User submits approval request** via Amazon API Gateway
 2. **Durable Function validates request** and creates a callback
-3. **UUID mapping stored in DynamoDB** (callback ID → UUID)
+3. **UUID mapping stored in Amazon DynamoDB** (callback ID → UUID)
 4. **Email notification sent via SNS** with approve/reject links
 5. **Function pauses execution** (no compute charges during wait)
 6. **Approver clicks link** in email
@@ -57,16 +57,11 @@ The pattern uses Lambda Durable Functions to implement a cost-effective approval
    sam deploy --guided --region us-east-2
    ```
 
-   During the guided deployment:
-   - Stack Name: `lambda-durable-hitl-approval`
-   - AWS Region: `us-east-2`
-   - Parameter ApproverEmail: `your-email@example.com`
-   - Confirm changes: `N`
-   - Allow SAM CLI IAM role creation: `Y`
-   - Disable rollback: `N`
-   - Save arguments to config file: `Y`
+   During the guided deployment, provide the required values:
+   - **ApproverEmail**: Enter your email address to receive approval notifications
+   - Allow SAM CLI to create IAM roles when prompted
 
-4. **Confirm SNS subscription**: Check your email and click the confirmation link from AWS SNS
+4. **Confirm SNS subscription**: Check your email and click the confirmation link from Amazon SNS
 
 5. Note the `ApiEndpoint` from the outputs
 
@@ -101,24 +96,9 @@ You'll receive an email with:
 
 ### Click Approve or Reject
 
-Click one of the links in the email. You'll see a confirmation page with:
-- ✓ or ✗ icon
-- "Request Approved!" or "Request Rejected!" message
-- Confirmation that the workflow has been notified
+Click one of the links in the email. You'll see a confirmation page that displays a checkmark or X icon along with either a "Request Approved!" or "Request Rejected!" message. The page will also confirm that the workflow has been notified of your decision.
 
-### Monitor the Workflow
 
-```bash
-# View durable function logs
-aws logs tail /aws/lambda/lambda-durable-hitl-approval-ApprovalFunction-XXXXX \
-  --follow \
-  --region us-east-2
-```
-
-Look for:
-- `Starting approval workflow for request: REQ-001`
-- `Approval request sent. UUID: <uuid>`
-- `Approval workflow completed: approved` (or `rejected`)
 
 ## How It Works
 
@@ -173,23 +153,13 @@ def lambda_handler(event, context):
     )
 ```
 
-### Cost Efficiency
-
-**Traditional Lambda approach:**
-- Cannot wait more than 15 minutes (Lambda max timeout)
-- Would need Step Functions or polling mechanism
-- Complex state management
-
-**Durable Functions approach:**
-- Wait up to 24 hours
-- No compute charges during wait
-- Simple, clean code
-- Automatic state management
 
 ## Configuration
 
 ### Adjust Timeout Duration
 
+To change the timeout duration, you need to update both the Lambda function configuration and the callback configuration:
+
 Modify in `template.yaml`:
 
 ```yaml
@@ -203,6 +173,8 @@ And in `src/lambda_function.py`:
 config=CallbackConfig(timeout=Duration.from_hours(24))
 ```
 
+Both values must match: `ExecutionTimeout` sets the maximum runtime for the durable function, while `CallbackConfig.timeout` sets how long the callback will wait before timing out.
+
 ### Change Email Address
 
 Update during deployment or redeploy with new email:
@@ -237,14 +209,7 @@ aws logs tail /aws/lambda/lambda-durable-hitl-approv-CallbackHandlerFunction-XXX
   --follow
 ```
 
-### DynamoDB Table
 
-Check the callback mappings:
-```bash
-aws dynamodb scan \
-  --table-name lambda-durable-hitl-approval-callbacks \
-  --region us-east-2
-```
 
 ## Cleanup
 
@@ -255,7 +220,7 @@ sam delete --stack-name lambda-durable-hitl-approval --region us-east-2
 
 ## Learn More
 
-- [Lambda Durable Functions Documentation](https://docs.aws.amazon.com/lambda/latest/dg/durable-functions.html)
+- [Lambda durable functions Documentation](https://docs.aws.amazon.com/lambda/latest/dg/durable-functions.html)
 - [Durable Execution SDK (Python)](https://github.com/aws/aws-durable-execution-sdk-python)
 - [Callback Operations](https://docs.aws.amazon.com/lambda/latest/dg/durable-callback.html)
 - [SendDurableExecutionCallbackSuccess API](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/lambda/client/send_durable_execution_callback_success.html)

lambda-durable-human-approval-sam/example-pattern.json

@@ -1,13 +1,13 @@
 {
-  "title": "Human-in-the-Loop Approval Workflow with Lambda Durable Functions",
+  "title": "Human-in-the-Loop Approval Workflow with Lambda durable functions",
   "description": "Approval workflow that pauses execution while waiting for human decisions, with automatic timeout handling and callback-based resumption",
   "language": "Python",
   "level": "300",
   "framework": "AWS SAM",
   "introBox": {
     "headline": "How it works",
     "text": [
-      "This pattern demonstrates a human-in-the-loop approval workflow using Lambda Durable Functions with callback operations.",
+      "This pattern demonstrates a human-in-the-loop approval workflow using Lambda durable functions with callback operations.",
       "The workflow pauses execution using create_callback() while waiting for human approval, incurring no compute charges during the wait period.",
       "If no decision is received within 24 hours, the workflow automatically times out and rejects the request.",
       "When an approver submits a decision via API, the durable function resumes from its checkpoint and processes the result.",
@@ -25,7 +25,7 @@
   "resources": {
     "bullets": [
       {
-        "text": "Lambda Durable Functions Documentation",
+        "text": "Lambda durable functions Documentation",
         "link": "https://docs.aws.amazon.com/lambda/latest/dg/durable-functions.html"
       },
       {
@@ -36,7 +36,7 @@
   },
   "deploy": {
     "text": [
-      "Note: Lambda Durable Functions are currently available in us-east-2 (Ohio) region only.",
+      "Note: Lambda durable functions have limited regional availability. Please check the AWS documentation for current regional support.",
       "sam build",
       "sam deploy --guided --region us-east-2"
     ]
@@ -56,7 +56,7 @@
       "name": "Abhishek Agawane",
       "image": "https://drive.google.com/file/d/1E-5koDaKEaMUtOctX32I9TLwfh3kgpAq/view?usp=drivesdk",
       "bio": "Abhishek Agawane is a Security Consultant at Amazon Web Services with more than 8 years of industry experience. He helps organizations architect resilient, secure, and efficient cloud environments, guiding them through complex challenges and large-scale infrastructure transformations. He has helped numerous organizations enhance their cloud operations through targeted optimizations, robust architectures, and best-practice implementations.",
-      "linkedin": "https://www.linkedin.com/in/agawabhi/"
+      "linkedin": "agawabhi"
     }
   ]
 }