Merge pull request #32 from parallelchain-io/refactor-workflows

Refactor workflows

Author: lyulka

.github/workflows/deploy-main.yml

@@ -0,0 +1,38 @@
+name: "Deploy `main` branch to GitHub Pages"
+run-name: "Deploy `main` (sha: ${{ github.sha }}) to Pages"
+
+on:
+  push:
+    branches:
+      - main
+
+permissions:
+    contents: write
+
+jobs:
+  deploy:
+    name: Deploy `main`
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout main branch 
+        uses: actions/checkout@v3
+
+      - name: Install Python
+        uses: actions/setup-python@v4
+        with:
+          # actions/setup-python recommends that python-version be fixed so that workflow runs are more 
+          # predictable.
+          python-version: '3.12.7'
+
+      - name: Install mkdocs
+        run: pip install mkdocs
+
+      - name: Install pymdown-extensions
+        run: pip install pymdown-extensions
+
+      - name: Install mkdocs-material
+        run: pip install mkdocs-material
+
+      # This step force-pushes the docs to the "gh-pages" branch of the parallelchain-docs repo.
+      - name: Build and deploy documentation
+        run: mkdocs gh-deploy --force

.github/workflows/deploy-pr-preview.yml

@@ -0,0 +1,50 @@
+name: Deploy PR preview to GitHub Pages
+run-name: "Deploy preview for PR #${{ github.event.pull_request.number }}"
+
+concurrency: preview-${{ github.ref }}
+
+on:
+  workflow_dispatch:
+  pull_request:
+    types:
+      - opened
+      - reopened
+      - synchronize
+      - closed
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  preview:
+    name: Deploy PR preview
+    runs-on: ubuntu-latest
+    steps:
+      - name: Cancel previous runs
+        uses: styfle/[email protected]
+
+      - name: Checkout PR source branch
+        uses: actions/checkout@v3
+
+      - name: Install Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: "3.12.7"
+
+      - name: Install mkdocs
+        run: pip install mkdocs
+
+      - name: Install pymdown-extensions
+        run: pip install pymdown-extensions
+
+      - name: Install mkdocs-material
+        run: pip install mkdocs-material
+
+      - name: Build documentation 
+        run: mkdocs build
+
+      - name: Deploy generated documentation 
+        uses: rossjrw/pr-preview-action@v1
+        with:
+          source-dir: ./site/