docs: change configuration to release docs only during the release or by hand. Rollback config for building doc for PR. (#1239)

Author: kozub

.github/workflows/build-docs.yml

@@ -0,0 +1,37 @@
+name: Build Docs
+
+on:
+  pull_request:
+    branches:
+      - main
+    paths:
+      - 'docs/**'
+      - 'mkdocs.yml'
+      - 'Makefile'
+
+  push:
+    branches:
+      - main
+    paths:
+      - 'docs/**'
+      - 'mkdocs.yml'
+      - 'Makefile'
+
+jobs:
+  docs:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: "3.8"
+      - name: Capture branch and tag
+        id: branch_name
+        run: |
+          echo "SOURCE_BRANCH=${GITHUB_REF#refs/heads/}" >> $GITHUB_ENV
+          echo "SOURCE_TAG=${GITHUB_REF#refs/tags/}" >> $GITHUB_ENV
+      - name: Build docs website
+        run: |
+          echo "GIT_PYTHON_REFRESH=quiet"
+          make build-docs-website

.github/workflows/on-doc-merge.yml renamed to .github/workflows/release-doc.yml

@@ -1,12 +1,10 @@
 name: Docs
 
 on:
-  push:
-    branches:
-      - main
-    paths:
-      - "docs/**"
-      - "mkdocs.yml"
+  release:
+    types:
+      - published
+  workflow_dispatch: {}
 
 jobs:
   release-docs: