docs(homepage): note about v2 version

.github/workflows/v2_on_push_docs.yml

@@ -0,0 +1,35 @@
+name: Docs v2
+
+on:
+  push:
+    branches:
+      - v2
+    paths:
+      - "docs/**"
+      - "mkdocs.yml"
+      - "examples/**"
+
+jobs:
+  changelog:
+    permissions:
+      contents: write
+    uses: ./.github/workflows/reusable_publish_changelog.yml
+
+  release-docs:
+    needs: changelog
+    permissions:
+      contents: write
+      pages: write
+    uses: ./.github/workflows/reusable_publish_docs.yml
+    with:
+      version: v2
+      alias: alpha
+# Maintenance: Only necessary in repo migration
+# - name: Create redirect from old docs
+#   run: |
+#     git checkout gh-pages
+#     test -f 404.html && echo "Redirect already set" && exit 0
+#     git checkout develop -- 404.html
+#     git add 404.html
+#     git commit -m "chore: set docs redirect" --no-verify
+#     git push origin gh-pages -f

docs/index.md

@@ -5,6 +5,9 @@ description: AWS Lambda Powertools for Python
 
 <!-- markdownlint-disable MD043 -->
 
+???+ danger
+    This documentation is for v2 that is not yet released.
+
 A suite of utilities for AWS Lambda functions to ease adopting best practices such as tracing, structured logging, custom metrics, idempotency, batching, and more.
 
 ???+ note