heitorlessa
diff --git a/‎.github/workflows/python_docs.yml
+1 b/‎.github/workflows/python_docs.yml
+1
diff --git a/‎CHANGELOG.md
+5-3 b/‎CHANGELOG.md
+5-3
diff --git a/‎CONTRIBUTING.md
+2-1 b/‎CONTRIBUTING.md
+2-1
diff --git a/‎Makefile
+10-9 b/‎Makefile
+10-9
diff --git a/‎docs/.prettierignore
-4 b/‎docs/.prettierignore
-4
diff --git a/‎docs/.prettierrc
-4 b/‎docs/.prettierrc
-4
diff --git a/‎docs/Dockerfile
+2 b/‎docs/Dockerfile
+2
diff --git a/‎docs/api/.gitkeep b/‎docs/api/.gitkeep
diff --git a/‎docs/changelog.md
+2 b/‎docs/changelog.md
+2
@@ -7,6 +7,7 @@ on:
   push:
     branches:
       - master
+      - docs/mkdocs
       # Disabled until docs support versioning per branch/release
       # - develop
   release:
 
@@ -1,8 +1,10 @@
-.# Changelog
+# Changelog
+
 All notable changes to this project will be documented in this file.
 
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+This project follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/) format for changes and adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+
 
 ## [Unreleased]
 
 
@@ -42,7 +42,8 @@ GitHub provides additional document on [forking a repository](https://help.githu
 You might find useful to run both the documentation website and the API reference locally while contributing:
 
 * **API reference**: `make docs-api-local`
-* **Docs website**: `make dev-docs` to install deps, and `make docs-local` to run it thereafter
+* **Docs website**: `make docs-local`
+	- If you prefer using Docker: `make docs-local-docker`
 
 ### Conventions
 
 
@@ -1,4 +1,4 @@
-.PHONY: target dev dev-docs format lint test coverage-html pr  build build-docs build-docs-api build-docs-website
+.PHONY: target dev format lint test coverage-html pr  build build-docs build-docs-api build-docs-website
 .PHONY: docs-local docs-api-local security-baseline complexity-baseline release-prod release-test release
 
 target:
@@ -9,9 +9,6 @@ dev:
 	poetry install --extras "pydantic"
 	pre-commit install
 
-dev-docs:
-	cd docs && yarn install
-
 format:
 	poetry run isort -rc aws_lambda_powertools tests
 	poetry run black aws_lambda_powertools tests
@@ -40,13 +37,17 @@ build-docs-api: dev
 	mv -f dist/api/aws_lambda_powertools/* dist/api/
 	rm -rf dist/api/aws_lambda_powertools
 
-build-docs-website: dev-docs
+build-docs-website: dev
 	mkdir -p dist
-	cd docs && yarn build
-	cp -R docs/public/* dist/
+	poetry run mkdocs build
+	cp -R site/* dist/
+
+docs-local:
+	poetry run mkdocs serve
 
-docs-local: dev-docs
-	cd docs && yarn start
+docs-local-docker:
+	docker build -t squidfunk/mkdocs-material ./docs/
+	docker run --rm -it -p 8000:8000 -v ${PWD}:/docs squidfunk/mkdocs-material
 
 docs-api-local:
 	poetry run pdoc --http : aws_lambda_powertools
 
@@ -0,0 +1,2 @@
+FROM squidfunk/mkdocs-material
+RUN pip install mkdocs-git-revision-date-plugin
@@ -0,0 +1,2 @@
+[comment]: <> (Includes Changelog content entire file as a snippet)
+--8<-- "CHANGELOG.md"
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,2 @@`
	`1`	`+FROM squidfunk/mkdocs-material`
	`2`	`+RUN pip install mkdocs-git-revision-date-plugin`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,2 @@`
	`1`	`+[comment]: <> (Includes Changelog content entire file as a snippet)`
	`2`	`+--8<-- "CHANGELOG.md"`