adapt GitHub workflow for python docs creation (#1375)

.github/workflows/python-docs.yml

@@ -16,6 +16,7 @@
 name: "build-python-docs-and-share-as-artifact"
 
 on:
+  workflow_dispatch:
   schedule:
     - cron:  "0 2 * * 6"  # runs every saturday at 00:00:00
 
@@ -26,6 +27,13 @@ jobs:
       - name: clone
         uses: actions/checkout@v3
 
+      - name: create working branch
+        uses: peterjgrainger/action-create-branch@v2.2.0
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          branch: 'build-python-docs-${{ github.run_id }}'
+
       - name: Set up Python
         uses: actions/setup-python@v4
         with:
@@ -49,11 +57,15 @@ jobs:
       - name: Build Python docs
         working-directory: ./streampipes-client-python
         run: |
-          make doc
+          mike deploy dev  --deploy-prefix ./streampipes-client-python/docs-tmp -b feature/python-doc-versioning 
 
       - name: Publish Python docs as artifact
         uses: actions/upload-artifact@v3
         with:
           name: streampipes-python-docs
-          path: streampipes-client-python/site/**/*
+          path: streampipes-client-python/docs-tmp/**/*
           retention-days: 5
+
+      - name: remove branch
+        run: |
+          git push origin --delete build-python-docs-${{ github.run_id }}