Demonstrate canonical API patterns

Always provide examples that demonstrate the recommended and most current API usage patterns. This includes:

1. Using the most up-to-date API operations (e.g., prefer ListObjectsV2 over ListObjects)
2. Showing proper parameter passing conventions (positional vs. keyword arguments)
3. Including handling for special cases like region-specific logic
4. Testing all examples to verify they work as documented

Examples should be concise but complete enough to show proper usage:

# CORRECT: Proper parameter passing for upload_file (positional arguments)
s3.upload_file(filename, bucket_name, key_name)

# INCORRECT: Attempting to use keyword arguments for positional parameters
s3.upload_file(Bucket=bucket_name, Filename=filename)  # This will fail!

# CORRECT: Handling region-specific bucket creation
bucket_config = {}
if region != "us-east-1":
    bucket_config["CreateBucketConfiguration"] = {"LocationConstraint": region}
s3.create_bucket(Bucket=bucket_name, **bucket_config)

# CORRECT: Using the recommended V2 API version
event_system.register('before-parameter-build.s3.ListObjectsV2', add_my_bucket)

Validating examples against the actual implementation helps catch discrepancies between documentation and behavior, ensuring developers can trust your API examples as authoritative references.