take care of comments

Author: Florian Chazal

docs/index.md

@@ -28,7 +28,7 @@ Core utilities such as Tracer, Logger, Metrics, and Event Handler will be availa
 
 ## Installation
 
-Powertools is available in the following formats:
+You can use Powertools through [AWS Lambda Layer](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-concepts.html#gettingstarted-concepts-layer) or install it as your dependency via NPM:
 
 * **Lambda Layer**: [**arn:aws:lambda:{region}:094274105915:layer:AWSLambdaPowertoolsTypeScript:1**](#){: .copyMe}:clipboard:
 * **NPM**: **`npm install @aws-lambda-powertools/tracer @aws-lambda-powertools/metrics @aws-lambda-powertools/logger`**
@@ -102,13 +102,16 @@ You can include Lambda Powertools Lambda Layer using [AWS Lambda Console](https:
     export class SampleFunctionWithLayer extends Construct {
         constructor(scope: Construct, id: string) {
             super(scope, id);
+            // Create a Layer with AWS Lambda Powertools for TypeScript
+
             const powertoolsLayer = lambda.LayerVersion.fromLayerVersionArn(
             this,
             'PowertoolsLayer',
             `arn:aws:lambda:${cdk.Stack.of(this).region}:094274105915:layer:AWSLambdaPowertoolsTypeScript:1`
             );
             new lambda.Function(this, 'Function', {
             runtime: lambda.Runtime.NODEJS_16_X,
+            // Add the Layer to a Lambda function
             layers: [powertoolsLayer],
             code: lambda.Code.fromInline(`
             const { Logger } = require('@aws-lambda-powertools/logger');

layer-publisher/README.md

@@ -1,6 +1,6 @@
 # Lambda Powertools for TypeScript Layer Publisher
 
-This CDK app is meant to be used to publish Powertools for TypeScript lambda layer. It is composed of a single stack deploying the layer into the target account.
+This CDK app is meant to be used to publish Powertools for TypeScript Lambda Layer. It is composed of a single stack deploying the Layer into the target account.
 
 # Usage
 
@@ -32,7 +32,7 @@ npm run test:e2e
 
 PS: You can force 
 * the lambda runtime to test with the RUNTIME env variable
-* the powertools version with VERSION env variable
+* the Powertools version with VERSION env variable
 ```sh 
 RUNTIME=node12.x VERSION=0.9.0 npm run test:e2e
 ```