Add versioning

Author: yuvalherziger

.github/workflows/publish.yaml

@@ -1,8 +1,7 @@
 name: Publish
 on:
-  push:
-    branches:
-      - main
+  release:
+    types: [created]
 jobs:
   deploy:
     runs-on: ubuntu-latest
@@ -11,8 +10,9 @@ jobs:
       - uses: actions/setup-python@v2
         with:
           python-version: 3.9
-      - run: pip install mkdocs-material
+      - run: pip install mkdocs-material mike
       - run: |
           cd keystone-docs
+          mike deploy --push --update-aliases ${{  github.ref_name }} latest
+          mike set-default --push latest
           mkdocs gh-deploy --force
-

keystone-docs/docs/index.md

@@ -12,6 +12,7 @@ the state of directory in a [data store](#supported-data-store).
 
 ![High level diagram](assets/img/how-it-works.png)
 
+Hello, again!
 
 ## Supported Data Store
 

keystone-docs/mkdocs.yml

@@ -1,11 +1,14 @@
-site_name: Keystone Documentation
+site_name: Keystone
 nav:
     - Welcome: index.md
     - Getting Started: getting-started.md
     - Configuration Reference: configuration.md
     - PostgerSQL Store: postgresql.md
     - MongoDB Store: mongodb.md
     - Cosmos DB Store: azure-cosmos-db.md
+extra:
+  version:
+    provider: mike
 markdown_extensions:
   - tables
   - admonition

poetry.lock

@@ -6,6 +6,7 @@ authors = ["Yuval Herziger <yherziger@microsoft.com>"]
 
 [tool.poetry.dependencies]
 python = "^3.9"
+mike = "^1.1.2"
 mkdocs = "^1.3.1"
 mkdocs-material = "^8.4.0"