PR: Add job to detect readme toc out of date

.github/workflows/check-documentation.yml

@@ -75,3 +75,28 @@ jobs:
           fail-if-changed: true
           files: |
              docs/website/references/http
+
+  check-readme-toc:
+    name: Check readme toc job
+
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code into the directory
+        uses: actions/checkout@v3
+
+      - name: Setup Go environment explicitly
+        uses: actions/setup-go@v3
+        with:
+          go-version: "1.21"
+          check-latest: true
+
+      - name: Try generating readme toc
+        run: make toc
+
+      - name: Check no new changes exist
+        uses: tj-actions/verify-changed-files@v20
+        with:
+          fail-if-changed: true
+          files: |
+             README.md