Fix docsite publish (#636)

* Add initial mkdocs docsite

* Add guide on mkdocs website dev

* Add Mkdocs website deployment stages

* Temp: build docsite on PR

* Publish the docsite when tags are pushed

Co-authored-by: Jason Axelson <[email protected]>

Author: Daniils Petrovs

.github/workflows/docsite.yml

@@ -0,0 +1,46 @@
+name: Build and Publish docsite
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  build:
+    name: Build Mkdocs website
+    runs-on: ubuntu-latest
+    strategy:
+        max-parallel: 1
+    container:
+      image: squidfunk/mkdocs-material
+    steps: 
+      - name: Checkout
+        uses: actions/[email protected]
+      - name: Build
+        run: mkdocs build -s
+      - name: Upload artifact
+        uses: actions/upload-artifact@v1
+        with:
+          name: site
+          path: site
+
+  publish:
+    needs: build
+    name: Publish Mkdocs website to GH Pages
+    runs-on: ubuntu-latest
+    strategy:
+      max-parallel: 1
+    steps:
+      - name: Checkout
+        uses: actions/[email protected]
+      - name: Download artifact
+        uses: actions/download-artifact@v1
+        with:
+          name: site
+          path: site
+      - name: Publish
+        uses: peaceiris/actions-gh-pages@v3
+        with:
+          publish_branch: mkdocs
+          publish_dir: site
+          github_token: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/release-asset.yml

@@ -88,21 +88,3 @@ jobs:
           asset_name: elixir-ls.zip
           asset_content_type: application/zip
 
-  build-docsite:
-    name: Build Mkdocs website
-    runs-on: ubuntu-latest
-    container:
-      image: squidfunk/mkdocs-material
-    steps:
-      - name: Build
-        run: mkdocs build -s
-
-  publish-docsite:
-    name: Publish Mkdocs website to GH Pages
-    runs-on: ubuntu-latest
-    steps:
-      - name: Publish
-        uses: JamesIves/[email protected]
-        with:
-          branch: mkdocs
-          folder: site