revised scripts and readmes

Author: mwunderl

tuts/003-s3-gettingstarted/README.md

@@ -1,21 +1,52 @@
-# Amazon S3 getting started
+# S3: Store and retrieve objects
 
-This tutorial demonstrates how to get started with Amazon S3 using the AWS CLI. You'll learn the fundamental concepts and operations for working with this AWS service through command-line interface.
+Create an S3 bucket, upload and download objects, enable versioning, configure encryption, and clean up.
 
-You can either run the automated script `s3-gettingstarted.sh` to execute all operations automatically with comprehensive error handling and resource cleanup, or follow the step-by-step instructions in the `s3-gettingstarted.md` tutorial to understand each AWS CLI command and concept in detail. The script includes interactive prompts and built-in safeguards, while the tutorial provides detailed explanations of features and best practices.
+## Source
 
-## Resources Created
+https://docs.aws.amazon.com/AmazonS3/latest/userguide/GetStartedWithS3.html
 
-The script creates the following AWS resources in order:
+## Use case
 
-- S3 bucket (primary bucket for tutorial)
-- S3 bucket (secondary bucket for cross-region replication)
-- S3 public access block configuration
-- S3 bucket versioning configuration
-- S3 bucket encryption configuration
-- S3 object (sample text file)
-- S3 object (sample image file)
-- S3 object (sample document file)
-- S3 bucket tagging configuration
+- ID: s3/getting-started
+- Phase: create
+- Complexity: beginner
+- Core actions: s3api:CreateBucket, s3api:PutObject, s3api:GetObject, s3api:CopyObject
 
-The script prompts you to clean up resources when you run it, including if there's an error part way through. If you need to clean up resources later, you can use the script log as a reference point for which resources were created.
+## What it does
+
+1. Creates an S3 bucket with a random name
+2. Uploads a sample text file
+3. Downloads and displays the file
+4. Copies the object to a folder prefix
+5. Enables versioning and uploads a second version
+6. Configures SSE-S3 encryption and blocks all public access
+7. Tags the bucket
+8. Lists objects and object versions
+9. Cleans up all objects and the bucket
+
+## Running
+
+```bash
+bash s3-gettingstarted.sh
+```
+
+To auto-run with cleanup:
+
+```bash
+echo 'y' | bash s3-gettingstarted.sh
+```
+
+## Resources created
+
+- S3 bucket (with versioning, encryption, public access block, tags)
+- Objects (sample file, copy, second version)
+
+## Estimated time
+
+- Run: ~15 seconds
+- Cleanup: ~5 seconds
+
+## Cost
+
+Free tier eligible. Minimal charges for a few small objects.