From 54b5e78278e3cc0b99b05186d3ec554773ec971b Mon Sep 17 00:00:00 2001
From: "github-actions[bot]"
 <41898282+github-actions[bot]@users.noreply.github.com>
Date: Mon, 6 Nov 2023 11:33:37 +0100
Subject: [PATCH] Update `make docs` procedure (#5701)

* Update `make docs` procedure

* Use versioned action to update `make-docs` procedure

https://github.com/grafana/writers-toolkit/blob/main/update-make-docs/action.yml

Signed-off-by: Jack Baldry <jack.baldry@grafana.com>

---------

Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
Co-authored-by: grafanabot <bot@grafana.com>
Co-authored-by: Jack Baldry <jack.baldry@grafana.com>
---
 .github/workflows/update-make-docs.yml | 23 ++++-------------------
 docs/make-docs                         |  2 +-
 2 files changed, 5 insertions(+), 20 deletions(-)

diff --git a/.github/workflows/update-make-docs.yml b/.github/workflows/update-make-docs.yml
index f2ae7dbb7781..188fd6bd80d1 100644
--- a/.github/workflows/update-make-docs.yml
+++ b/.github/workflows/update-make-docs.yml
@@ -2,26 +2,11 @@ name: Update `make docs` procedure
 on:
   schedule:
     - cron: '0 7 * * 1-5'
+  workflow_dispatch:
 jobs:
   main:
+    if: github.repository == 'grafana/agent'
     runs-on: ubuntu-latest
     steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-
-      - name: Update procedure
-        if: github.repository != 'grafana/writers-toolkit'
-        run: |
-          BRANCH=update-make-docs
-          git checkout -b "${BRANCH}"
-          curl -s -Lo docs/docs.mk https://raw.githubusercontent.com/grafana/writers-toolkit/main/docs/docs.mk
-          curl -s -Lo docs/make-docs https://raw.githubusercontent.com/grafana/writers-toolkit/main/docs/make-docs
-          if git diff --exit-code; then exit 0; fi
-          git add .
-          git config --local user.email "bot@grafana.com"
-          git config --local user.name "grafanabot"
-          git commit -m "Update \`make docs\` procedure"
-          git push -v origin "refs/heads/${BRANCH}"
-          gh pr create --fill || true
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      - uses: actions/checkout@v4
+      - uses: grafana/writers-toolkit/update-make-docs@update-make-docs/v1
diff --git a/docs/make-docs b/docs/make-docs
index badc36a470f1..751e22f4fd48 100755
--- a/docs/make-docs
+++ b/docs/make-docs
@@ -38,7 +38,7 @@
 #
 # - Imperfect implementation of container name.
 #
-#   Faciliates running `make vale` and `make docs` at once.
+#   Facilitates running `make vale` and `make docs` at once.
 #   Container names are convenient for recognition in `docker ps` but the current implementation has more downsides than upsides.
 #
 # - Forced platform specification now that multiple architecture images exist.