docs(theme): upgrade mkdocs-material to 8.x (aws-powertools#1002)

Author: heitorlessa

.gitignore

@@ -1,4 +1,3 @@
-
 # Created by https://www.gitignore.io/api/osx,linux,python,windows,pycharm,visualstudiocode
 # Edit at https://www.gitignore.io/?templates=osx,linux,python,windows,pycharm,visualstudiocode
 
@@ -304,3 +303,4 @@ node_modules
 api/
 site/
 !404.html
+!docs/overrides/*.html

docs/index.md

@@ -454,5 +454,7 @@ As a best practice, AWS Lambda Powertools module logging statements are suppress
 ```python title="Powertools debug mode example"
 from aws_lambda_powertools.logging.logger import set_package_logger
 
-set_package_logger()
+set_package_logger() # (1)
 ```
+
+1.  :information_source: this will configure our `aws_lambda_powertools` logger with debug.

docs/overrides/assets/images/powertools_docs_thumbnail.png

@@ -0,0 +1,8 @@
+{% extends "base.html" %}
+
+{% block outdated %}
+  You're not viewing the latest version.
+  <a href="{{ '../' ~ base_url }}">
+    <strong>Click here to go to latest.</strong>
+  </a>
+{% endblock %}

docs/overrides/main.html

@@ -52,6 +52,8 @@ theme:
     - navigation.top
     - navigation.instant
     - navigation.indexes
+    - navigation.tracking
+    - content.code.annotate
   icon:
     repo: fontawesome/brands/github
   logo: media/aws-logo-light.svg
@@ -60,10 +62,10 @@ theme:
 
 markdown_extensions:
   - admonition
-  - pymdownx.tabbed
+  - pymdownx.tabbed:
+      alternate_style: true
   - pymdownx.highlight:
       linenums: true
-  - pymdownx.superfences
   - pymdownx.details
   - pymdownx.snippets:
       base_path: "."
@@ -75,7 +77,7 @@ markdown_extensions:
   - attr_list
   - pymdownx.emoji
   - pymdownx.inlinehilite
-  - attr_list
+  - pymdownx.superfences
 
 copyright: Copyright © 2021 Amazon Web Services
 
@@ -92,3 +94,4 @@ extra_javascript:
 extra:
   version:
     provider: mike
+    default: latest

mkdocs.yml

@@ -50,10 +50,10 @@ radon = "^5.1.0"
 xenon = "^0.8.0"
 flake8-eradicate = "^1.2.0"
 flake8-bugbear = "^22.1.11"
-mkdocs-material = "^7.3.6"
 mkdocs-git-revision-date-plugin = "^0.3.1"
 mike = "^0.6.0"
 mypy = "^0.931"
+mkdocs-material = "^8.1.9"
 
 
 [tool.poetry.extras]