From 41b193b124afe9c39e4cdabb0218adfcf300420a Mon Sep 17 00:00:00 2001
From: asyncapi-bot <bot+chan@asyncapi.io>
Date: Tue, 7 Nov 2023 14:03:16 +0100
Subject: [PATCH] ci: update of files from global .github repo (#255)

---
 .../workflows/update-docs-on-docs-commits.yml | 48 ++++++++++++++-----
 1 file changed, 36 insertions(+), 12 deletions(-)

diff --git a/.github/workflows/update-docs-on-docs-commits.yml b/.github/workflows/update-docs-on-docs-commits.yml
index 35f1d2d97..b511e284d 100644
--- a/.github/workflows/update-docs-on-docs-commits.yml
+++ b/.github/workflows/update-docs-on-docs-commits.yml
@@ -1,3 +1,10 @@
+# This workflow is centrally managed in https://github.com/asyncapi/.github/
+# Don't make changes to this file in this repo as they will be overwritten with changes made to the same file in above mentioned repo
+
+# The given workflow is responsible for generating docs and creating PR with them when there is a commit with docs: prefix
+
+# This workflow will be updated in all repos with the topic get-global-docs-autoupdate
+
 name: 'Update generated parts of documentation on docs: commits'
 
 on:
@@ -9,25 +16,42 @@ jobs:
   docs-gen:
     name: 'Generate docs and create PR'
     runs-on: ubuntu-latest
+    # PR should be created within this GH action only if it is a docs: commit
+    # Otherwise it will conflict with release workflow
+    if: startsWith(github.event.commits[0].message, 'docs:')
     steps:
       - name: Checkout repo
-        uses: actions/checkout@v2
-      - name: Setup Node.js
-        uses: actions/setup-node@v1
+        uses: actions/checkout@v4
+      - name: Check package-lock version
+        uses: asyncapi/.github/.github/actions/get-node-version-from-package-lock@master
+        id: lockversion
+      - name: Use Node.js
+        uses: actions/setup-node@v3
         with:
-          node-version: 13
+          node-version: "${{ steps.lockversion.outputs.version }}"
+          cache: 'npm'
+          cache-dependency-path: '**/package-lock.json'
       - name: Install dependencies
         run: npm ci
-      - name: Generate docs
-        run: npm run generate:assets
+      - name: Regenerate docs
+        run: npm run generate:assets --if-present
       - name: Create Pull Request with updated docs
-        # Pull request should be created within this GitHub action only if it is a docs: commit
-        # Otherwise it will conflict with release workflow
-        if: startsWith(github.event.commits[0].message, 'docs:')
-        uses: peter-evans/create-pull-request@v3
+        uses: peter-evans/create-pull-request@153407881ec5c347639a548ade7d8ad1d6740e38 # uses 5.0.2 https://github.com/peter-evans/create-pull-request/releases/tag/v5.0.2
         with:
-          token: ${{ secrets.GITHUB_TOKEN }} #this is default token of github-action actor
+          token: ${{ secrets.GH_TOKEN }}
           commit-message: 'chore: update generated docs'
+          committer: asyncapi-bot <info@asyncapi.io>
+          author: asyncapi-bot <info@asyncapi.io>
           title: 'chore: update generated docs'
           body: 'Update of docs that are generated and were forgotten on PR level.'
-          branch: gen-docs-update
\ No newline at end of file
+          branch: gen-docs-update/${{ github.job }}
+      - name: Report workflow status to Slack
+        if: failure() # Only, on failure, send a message on the 94_bot-failing-ci slack channel
+        uses: 8398a7/action-slack@fbd6aa58ba854a740e11a35d0df80cb5d12101d8 #using https://github.com/8398a7/action-slack/releases/tag/v3.15.1
+        with:
+          status: ${{ job.status }}
+          fields: repo,action,workflow
+          text: 'AsyncAPI docs generation workflow failed'
+          author_name: asyncapi-bot
+        env:
+          SLACK_WEBHOOK_URL: ${{ secrets.SLACK_CI_FAIL_NOTIFY }}     
\ No newline at end of file