Manual execution for staging docs (#90)

* Manual execution for staging docs

* Makefile fix

.github/workflows/staging.yml

@@ -2,9 +2,13 @@ name: Build and Deploy to Netlify Staging
 # This workflow runs manually to deploy the
 # CometBFT documentation staging website to Netlify
 on:
-  push:
-    branches:
-      - main
+  workflow_dispatch:
+    inputs:
+      branch:
+        description: 'CometBFT branch with documentation'
+        required: false
+        default: 'staging-docs'
+        type: string
 jobs:
   build:
     name: Build and deploy to Netlify (Staging)
@@ -20,10 +24,10 @@ jobs:
         uses: actions/checkout@v3
       # Clone the cometbft repo
       - name: Fetch cometbft repo
-        run: make STAGING_DOCS=true fetch
+        run: make STAGING_DOCS=true STAGING_BRANCH=${{ inputs.branch }} fetch
       # Generate _data folder content
       - name: Build versions data
-        run: make STAGING_DOCS=true versions-data
+        run: make STAGING_DOCS=true STAGING_BRANCH=${{ inputs.branch }} versions-data
       # Install Jekyll dependencies
       - name: Install dependencies
         run: |

Makefile

@@ -2,6 +2,9 @@
 ###                           Documentation                                 ###
 ###############################################################################
 
+# When deploying to the staging server, deploy from this branch.
+STAGING_BRANCH?=staging-docs
+
 # Clone repository branches and copy docs and spec folders into our _pages
 # collection.
 fetch: clean versions-data
@@ -36,9 +39,9 @@ fetch: clean versions-data
 		echo ""; \
 	fi
 	@if [ "${STAGING_DOCS}" ]; then \
-		echo "-----> Checking out staging-docs" ; \
+		echo "-----> Checking out ${STAGING_BRANCH}" ; \
   	cd build/cometbft ; \
-  	git checkout staging-docs ; \
+  	git checkout "${STAGING_BRANCH}" ; \
   	cd ../.. ; \
   	mkdir -pv _pages/staging/spec ; \
   	mkdir -pv _pages/staging/rpc ; \
@@ -85,7 +88,7 @@ versions-data:
 	fi
 	@if [ "${STAGING_DOCS}" ]; then \
 		echo "Adding \"staging\" version"; \
-		echo "- branch: staging-docs" >> _data/versions.yml; \
+		echo "- branch: ${STAGING_BRANCH}" >> _data/versions.yml; \
 		echo "  output_path: staging" >> _data/versions.yml; \
 		echo "  visible: true" >> _data/versions.yml; \
 		echo "output_path: staging" > _data/default_version.yml ; \