readme updates

Author: rjtokenring

README.md

@@ -8,8 +8,8 @@ By default, data extraction is performed every hour, extracting samples aggregat
 
 S3 exporter is based on a Go lambda function triggered by periodic event from EventBridge.
 Job is configured to extract samples for a 60min time window with the default resolution of 5min.
-One file is created per execution, containing all samples for selected things. Time series samples are exported at UTC timezone.
-By default, all Arduino things present in the account are exported: it is possible to filter them via tags configuration.
+One file is created per execution and contains all samples for selected things. Time series samples are exported at UTC timezone.
+By default, all Arduino things present in the account are exported: it is possible to filter them via [tags](#tag-filtering).
 
 CSV produced has the following structure:
 ```console
@@ -20,7 +20,7 @@ timestamp,thing_id,thing_name,property_id,property_name,property_type,value
 2024-09-04T11:03:00Z,07846f3c-37ae-4722-a3f5-65d7b4449ad3,H7,137c02d0-b50f-47fb-a2eb-b6d23884ec51,m3,FLOAT,15
 ```
 
-Files are organized in S3 bucket by date and files of the same day are grouped.
+Files are organized by date and files of the same day are grouped.
 ```
 <bucket>:2024-09-04/2024-09-04-10.csv
 <bucket>:2024-09-04/2024-09-04-11.csv
@@ -31,39 +31,39 @@ Files are organized in S3 bucket by date and files of the same day are grouped.
 
 It is possible to deploy required resources via [cloud formation template](deployment/cloud-formation-template/deployment.yaml)
 
-CFT deployment requires:
-* an AWS account with rights for creating a new CFT stack. Account must have rights to create:
-  * S3 buckets
-  * IAM Roles
-  * Lambda functions
-  * EventBridge rules
-  * SSM parameters (Parameter store)
+AWS user must have permissions to:
+  * create a new CFT stack (policy: AWSCloudFormationFullAccess)
+  * S3 buckets (policy: AmazonS3FullAccess)
+  * IAM Roles (policy: IAMFullAccess)
+  * Lambda functions (policy: AWSLambda_FullAccess)
+  * EventBridge rules (policy: AmazonEventBridgeFullAccess)
+  * SSM parameters (Parameter store) (policy: AmazonSSMFullAccess)
 
-Before stack creation, two S3 buckets has to be created:
+Before stack creation, two S3 buckets have to be created:
 * a temporary bucket where lambda binaries and CFT can be uploaded
 * CSVs destination bucket, where all generated file will be uploaded 
 bucket must be in the same region where stack will be created.
 
-To deploy stack, follow these steps:
+Follow these steps to deploy a new stack:
 * download [lambda code binaries](deployment/binaries/arduino-s3-integration-lambda.zip) and [Cloud Formation Template](deployment/cloud-formation-template/deployment.yaml)
-* Upload CFT and binary zip file on an S3 bucket accessible by the AWS account. For the CFT yaml file, copy the Object URL (it will be required in next step).
+* upload CFT and binary zip file on an S3 bucket accessible by the AWS account. For the CFT yaml file, copy the Object URL (it will be required in next step).
 
 ![object URL](docs/objecturl.png)
 
-* Start creation of a new cloud formation stack. Follow these steps:
+* start creation of a new cloud formation stack
 
 ![CFT 1](docs/cft-stack-1.png)
 
-* Fill all required parameters.
+* fill all required parameters.
   <br/>**Mandatory**: Arduino API key and secret, S3 bucket where code has been uploaded, destination S3 bucket
   <br/>**Optional**: tag filter for filtering things, organization identifier and samples resolution
 
 ![CFT 2](docs/cft-stack-2.png)
 
 ### Configuration parameters
 
-Here is a list of all configuration properties available in 'Parameter store'.
-These parameters are filled by CFT and can be adjusted later in case of need (for example, API keys rotation)
+Here is a list of all configuration properties supported by exporter. It is possible to edit them in AWS Parameter store.
+These parameters are filled by CFT at stack creation time and can be adjusted later in case of need (for example, API keys rotation)
 
 | Parameter | Description |
 | --------- | ----------- |
@@ -76,17 +76,16 @@ These parameters are filled by CFT and can be adjusted later in case of need (fo
 
 ### Tag filtering
 
-It is possible to filter only the Things of interest.
-You can use tag filtering if you need to reduce data export to a specific set of Things.
+It is possible to filter only the Arduino Things of interest.
+You can use tag filtering if you need to reduce export to a specific set of Things.
 
-* Add a tag in Arduino Cloud UI on all Things you want to export. To do that, select a thing and go in 'metadata' section and add a new tag.
+* Add a tag in Arduino Cloud UI on all Things you want to export. To do that, select a thing, go in 'Metadata' section and 'Add' a new tag.
 
+![tag 2](docs/tag-2.png)
 
 ![tag 1](docs/tag-1.png)
 
-![tag 2](docs/tag-2.png)
-
-* Configure tag filter during CFT creation of by editing '/arduino/s3-importer/iot/filter/tags' parameter.
+* Configure tag filter during CFT creation of by editing '/arduino/s3-importer/iot/filter/tags' parameter (syntax: tag1=value1,tag2=value2).
 
 ![tag filter](docs/tag-filter.png)