Documentation Update: Properly create tags and aliases, add workflow to delete unwanted / old versions

Signed-off-by: Mario Sarcher <msarcher@mirantis.com>

.github/workflows/main.yml

@@ -3,7 +3,8 @@ on:
   push:
     branches:
       - master
-
+    tags:
+      - 'v*'
 jobs:
   build:
     name: Deploy docs
@@ -27,13 +28,12 @@ jobs:
       - name: Checkout Release from lens
         uses: actions/checkout@v2
         with:
-          repository: lensapp/lens
+          fetch-depth: 0
 
       - name: git config
         run: |
            git config --local user.email "action@github.com"
            git config --local user.name "GitHub Action"
-           git pull
 
       - name: Using Node.js ${{ matrix.node-version }}
         uses: actions/setup-node@v1
@@ -46,16 +46,14 @@ jobs:
            yarn typedocs-extensions-api
 
       - name: mkdocs deploy latest
+        if: contains(github.ref, 'refs/heads/master')
         run: |
-           mike deploy --push latest
+           mike deploy --push --update-aliases master latest
 
 
       - name: mkdocs deploy new release / tag
         if: contains(github.ref, 'refs/tags/v')
         run: |
-           mike deploy --push--update-aliases ${{ github.ref }} latest
-           mike set-default --push ${{ github.ref }}
-
-
-
-
+           VERSION=$(git describe --tags `git rev-list --tags --max-count=1`)
+           mike deploy --push --update-aliases $VERSION latest
+           mike set-default --push $VERSION

.github/workflows/mkdocs-delete-version.yml

@@ -0,0 +1,37 @@
+name: Delete Documentation Version
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Version string to be deleted (e.g."v0.0.1")'
+        required: true
+jobs:
+  build:
+    name: Delete docs Version
+    runs-on: ubuntu-latest
+    steps:
+      - name: Set up Python 3.7
+        uses: actions/setup-python@v2
+        with:
+          python-version: '3.x'
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install git+https://${{ secrets.GH_TOKEN }}@github.com/lensapp/mkdocs-material-insiders.git
+          pip install mike
+          
+      - name: Checkout Release from lens
+        uses: actions/checkout@v2
+        with:
+          fetch-depth: 0
+
+      - name: git config
+        run: |
+           git config --local user.email "action@github.com"
+           git config --local user.name "GitHub Action"
+
+
+      - name: mkdocs delete version
+        run: |
+           mike delete --push ${{ github.event.inputs.version }}