Add mike versioned docs

Author: alganet

.github/workflows/docs.yml

@@ -0,0 +1,51 @@
+# SPDX-FileCopyrightText: 2025 Alexandre Gomes Gaigalas <alganet@gmail.com>
+#
+# SPDX-License-Identifier: ISC
+
+name: Documentation
+
+on:
+  push:
+    branches: [main]
+    tags:
+      - 'v*'
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - uses: actions/setup-python@v6
+        with:
+          python-version: '3.13'
+
+      - name: Install dependencies
+        run: |
+          pip install -e .[dev]
+
+      - name: Configure Git
+        run: |
+          git config user.name github-actions[bot]
+          git config user.email 41898282+github-actions[bot]@users.noreply.github.com
+
+      - name: Deploy dev-main docs
+        if: github.ref == 'refs/heads/main'
+        run: |
+          mike deploy --push --branch website dev-main
+
+      - name: Deploy versioned docs
+        if: startsWith(github.ref, 'refs/tags/v')
+        run: |
+          VERSION=${GITHUB_REF#refs/tags/v}
+          mike deploy --push --update-aliases --branch website $VERSION latest
+          mike set-default --push --branch website latest

mkdocs.yml

@@ -4,7 +4,7 @@
 
 site_name: apywire
 site_description: A Python package for lazy object wiring and dependency injection
-site_url: https://github.com/alganet/apywire
+site_url: https://alganet.github.io/apywire/
 repo_url: https://github.com/alganet/apywire
 repo_name: alganet/apywire
 
@@ -33,6 +33,10 @@ theme:
     - search.highlight
     - content.code.copy
 
+extra:
+  version:
+    provider: mike
+
 nav:
   - Home: index.md
   - Getting Started: getting-started.md

pyproject.toml

@@ -42,6 +42,7 @@ dev = [
     "flake8-pyproject",
     "flake8",
     "isort",
+    "mike",
     "mkdocs-autorefs",
     "mkdocs-material",
     "mkdocs",