ci: update publish docs workflow (#2734)

* ci: update publish docs workflow

* update step name

* run format

Author: eglitise

.github/workflows/build-docs.yml

@@ -25,7 +25,7 @@ jobs:
           node-version: lts/*
           cache: 'npm'
       - name: Install dependencies (Node.js)
-        run: npm install
+        run: npm ci
       - name: Install dependencies (Python)
         run: npm run install-docs-deps
       - name: Build Docs

.github/workflows/package.yml

@@ -1,4 +1,8 @@
-name: Create packages
+# Builds the desktop and plugin versions of the app.
+# The plugin version is published to npm, while the desktop app packages
+# are uploaded to a GitHub release for the latest app version tag.
+
+name: Package and Publish
 
 on:
   workflow_dispatch:

.github/workflows/publish-docs.yml

@@ -1,9 +1,14 @@
 # Builds and publishes the Appium Inspector MkDocs documentation
+# Executed on-demand, or after publishing new version packages
 
 name: Publish Docs
 
 on:
   workflow_dispatch:
+  workflow_run:
+    workflows: ['Package and Publish']
+    types:
+      - completed
 
 jobs:
   build:
@@ -20,8 +25,10 @@ jobs:
           node-version: lts/*
           cache: 'npm'
       - name: Install dependencies (Node.js)
-        run: npm install
+        run: npm ci
       - name: Install dependencies (Python)
         run: npm run install-docs-deps
+      - name: Fetch docs branch
+        run: git fetch origin docs-site:docs-site || true
       - name: Build and deploy docs
         run: npm run publish:docs