add pre-commit hook and enforce one line per sentence rule

Author: HarshCasper

.markdownlint-cli2.yaml

@@ -2,22 +2,25 @@ globs:
   - 'content/**/*.md'
 ignores:
   - 'node_modules'
+  # Weird behavior with markdownlint; TODO: Fix
+  - 'content/en/tutorials/cloud-pods-collaborative-debugging/*'
+  - 'content/en/user-guide/integrations/terraform/*'
 customRules:
   - markdownlint-rule-max-one-sentence-per-line
 config:
-  MD029: false
-  MD046: false
-  MD025: false
-  MD001: false
-  MD024: false
-  MD055: false
-  MD056: false
-  MD036: false
-  MD003: false
-  MD033: false
-  MD013: false
-  MD034: false
-  MD032: false
+  MD029: false # Ordered list item prefix
+  MD046: false # Code block style
+  MD025: false # Single H1
+  MD001: false # Header levels increment by one
+  MD024: false # Multiple headers with the same content
+  MD055: false # Inconsistent leading and trailing pipe characters
+  MD056: false # Inconsistent Table column count
+  MD036: false # Emphasis used instead of a header
+  MD003: false # Header style
+  MD033: false # Inline HTML
+  MD013: false # Line length
+  MD034: false # Bare URL used
+  MD032: false # Lists should be surrounded by blank lines
   blanks-around-headings:
     lines_above: 0
     lines_below: 1

.pre-commit-config.yaml

@@ -0,0 +1,6 @@
+repos:
+  - repo: https://github.com/DavidAnson/markdownlint-cli2
+    rev: v0.13.0
+    hooks:
+      - id: markdownlint-cli2
+        args: ['--fix']

content/en/academy/localstack-101/lesson-3/index.md

@@ -14,7 +14,8 @@ url: "/academy/localstack-101/why-localstack/"
 ---
 
 Let's imagine this scenario: Alice, a software developer, takes on the task of creating a serverless
-Web application on AWS Cloud. However, she faces slow and tedious development due to cloud dependencies (DBs, VMs, MQs, etc.).
+Web application on AWS Cloud.
+However, she faces slow and tedious development due to cloud dependencies (DBs, VMs, MQs, etc.).
 Every local change needs to be packaged and uploaded to the cloud for testing.
 The solution for her trouble is LocalStack — a revolutionary platform that brings cloud resources to her
 local machine, enabling efficient development and testing.

content/en/academy/localstack-101/lesson-4/index.md

@@ -19,7 +19,8 @@ Discover multiple pathways to initiate your LocalStack experience:
 You'll understand the diverse approaches to LocalStack installation:
 
 1. Quickstart with LocalStack CLI:
-- Install `awscli-local` and `localstack` via `pip install`. On macOS you can use `brew install`.
+- Install `awscli-local` and `localstack` via `pip install`.
+  On macOS you can use `brew install`.
 - Start LocalStack using `localstack start`.
 - Create a bucket and list buckets using `awslocal s3 mb s3://test` and `awslocal s3 ls`.
 2. Alternative - Docker: Dive into an alternate installation method using Docker: pull the image and run it, it's that easy.

content/en/academy/localstack-101/lesson-5/index.md

@@ -18,7 +18,8 @@ In this informative video we guide you through the essential steps of the LocalS
 - Witness the seamless login flow and discover how to configure the web app.
 - Learn how to effortlessly connect your LocalStack Account to enable a smooth integration experience.
 - Explore the Resource Browser as we demonstrate how to list and create fundamental resources.
-- To create an account for LocalStack, visit [app.localstack.cloud/sign-up](https://app.localstack.cloud/sign-up). You can sign up with your email address or one of our supported social identity providers (such as GitHub).
+- To create an account for LocalStack, visit [app.localstack.cloud/sign-up](https://app.localstack.cloud/sign-up).
+  You can sign up with your email address or one of our supported social identity providers (such as GitHub).
 
 Further reading:
 

content/en/academy/localstack-101/lesson-6/index.md

@@ -14,7 +14,8 @@ url: "/academy/localstack-101/full-project-demo/"
 
 Discover the ins and outs of one of our Developer Hub's practical sample applications—a note-taking platform.
 This video tutorial offers a comprehensive walk-through, beginning with the checkout of the GitHub project and
-culminating in deploying the operational application on LocalStack. Covering the essentials, we'll guide you
+culminating in deploying the operational application on LocalStack.
+Covering the essentials, we'll guide you
 through dependency installation, backend and frontend build, and a detailed exploration of the application's service
 diagram to unveil the integral components at play.
 

content/en/academy/localstack-development/lesson-2/index.md

@@ -11,7 +11,8 @@ type: lessons
 url: "/academy/localstack-deployment/deploy-app-ls/"
 ---
 
-In this lesson, we'll guide you through deploying a [continer-based application](https://github.com/localstack/localstack-workshop/tree/main/02-serverless-api-ecs-apigateway), which mimics the complexity of a real-world application. We are using the following AWS services and their features to build our infrastructure:
+In this lesson, we'll guide you through deploying a [continer-based application](https://github.com/localstack/localstack-workshop/tree/main/02-serverless-api-ecs-apigateway), which mimics the complexity of a real-world application.
+We are using the following AWS services and their features to build our infrastructure:
 
 - [Elastic Container Service](https://docs.localstack.cloud/user-guide/aws/elastic-container-service/) to create and deploy our containerized application.
 - [DynamoDB](https://docs.localstack.cloud/user-guide/aws/dynamodb/) as a key-value and document database to persist our data.

content/en/academy/localstack-development/lesson-3/index.md

@@ -11,9 +11,11 @@ type: lessons
 url: "/academy/localstack-deployment/ls-integrations/"
 ---
 
-LocalStack integrates with various Infrastructure as Code tools like [Terraform](https://docs.localstack.cloud/user-guide/integrations/terraform/) or [Pulumi](https://docs.localstack.cloud/user-guide/integrations/pulumi/) assist in configuration management with added advantages like version control, ease of editing, and reproducibility. Additionally, LocalStack integrates with various CI platforms, such as [GitHub Actions](https://docs.localstack.cloud/user-guide/ci/github-actions/) or [CircleCI](https://docs.localstack.cloud/user-guide/ci/circle-ci/), to enable the cloud integrations tests before pushing changes to production.
+LocalStack integrates with various Infrastructure as Code tools like [Terraform](https://docs.localstack.cloud/user-guide/integrations/terraform/) or [Pulumi](https://docs.localstack.cloud/user-guide/integrations/pulumi/) assist in configuration management with added advantages like version control, ease of editing, and reproducibility.
+Additionally, LocalStack integrates with various CI platforms, such as [GitHub Actions](https://docs.localstack.cloud/user-guide/ci/github-actions/) or [CircleCI](https://docs.localstack.cloud/user-guide/ci/circle-ci/), to enable the cloud integrations tests before pushing changes to production.
 
-We discuss how LocalStack integrates with infrastructure-as-code (IaC) and continuous integration (CI) tools. Towards the end, we'll demonstrate a [Terraform deployment of a PostgreSQL Aurora cluster](https://github.com/terraform-aws-modules/terraform-aws-rds-aurora/tree/v8.1.1/examples/postgresql) on LocalStack, highlighting the time and resource savings compared to deploying directly on AWS.
+We discuss how LocalStack integrates with infrastructure-as-code (IaC) and continuous integration (CI) tools.
+Towards the end, we'll demonstrate a [Terraform deployment of a PostgreSQL Aurora cluster](https://github.com/terraform-aws-modules/terraform-aws-rds-aurora/tree/v8.1.1/examples/postgresql) on LocalStack, highlighting the time and resource savings compared to deploying directly on AWS.
 
 Additionally, we'll provide examples of using LocalStack with Terraform and Pulumi for reference.
 

content/en/academy/localstack-development/lesson-4/index.md

@@ -11,7 +11,9 @@ type: lessons
 url: "/academy/localstack-deployment/infra-terraform/"
 ---
 
-In this video, we'll utilize Terraform to deploy AWS resources locally through LocalStack. These resources include DynamoDB tables, API Gateway, and VPC. We'll use `tflocal`, a wrapper CLI that serves as a wrapper on the `terraform` CLI to execute Terraform commands against LocalStack.
+In this video, we'll utilize Terraform to deploy AWS resources locally through LocalStack.
+These resources include DynamoDB tables, API Gateway, and VPC.
+We'll use `tflocal`, a wrapper CLI that serves as a wrapper on the `terraform` CLI to execute Terraform commands against LocalStack.
 
 Here's a breakdown of the steps we'll take:
 

content/en/academy/localstack-development/lesson-5/index.md

@@ -11,7 +11,9 @@ type: lessons
 url: "/academy/localstack-deployment/infra-cloudformation/"
 ---
 
-In this video, we'll utilize [AWS CloudFormation](https://docs.localstack.cloud/user-guide/aws/cloudformation/) to deploy AWS resources locally through LocalStack. These resources include DynamoDB tables, API Gateway, and VPC. We'll use `awslocal`, a wrapper CLI that serves as a wrapper on the `aws` CLI to execute Terraform commands against LocalStack.
+In this video, we'll utilize [AWS CloudFormation](https://docs.localstack.cloud/user-guide/aws/cloudformation/) to deploy AWS resources locally through LocalStack.
+These resources include DynamoDB tables, API Gateway, and VPC.
+We'll use `awslocal`, a wrapper CLI that serves as a wrapper on the `aws` CLI to execute Terraform commands against LocalStack.
 
 Here's a breakdown of the steps we'll take: