Doc fixes 1.17 (#10269)

Co-authored-by: soloio-bulldozer[bot] <48420018+soloio-bulldozer[bot]@users.noreply.github.com>

.github/workflows/push-docs.yaml

@@ -158,4 +158,37 @@ jobs:
           --base main \
           --head ${{ steps.create-branch.outputs.branch }} \
           --reviewer solo-io/solo-docs
-        popd || exit 1
+        popd || exit 1
+
+  slack-notification:
+    runs-on: ubuntu-latest
+    needs:
+      - copy-docs
+    steps:
+    - name: Notify on workflow success
+      if: |
+        needs.copy-docs.result == 'success'
+      env:
+        SLACK_BOT_TOKEN: ${{ secrets.SLACK_BOT_TOKEN }}
+      run: |
+        MESSAGE="✅ *Success:* Automated copy of reference docs for ${{ steps.version-variables.outputs.minor }} was successful. <https://github.com/solo-io/docs/pulls|Review the PR>"
+
+        curl \
+          -d "text=$MESSAGE" \
+          -d "channel=doctopus-tests" \
+          -d "token=${SLACK_BOT_TOKEN}" \
+          -X POST https://slack.com/api/chat.postMessage
+    - name: Notify on workflow failure
+      if: |
+        needs.copy-docs.result == 'failure'
+      env:
+        SLACK_BOT_TOKEN: ${{ secrets.SLACK_BOT_TOKEN }}
+      run: |
+        JOB_URL=https://github.com/solo-io/gloo/actions/runs/${GITHUB_RUN_ID}
+        MESSAGE="❌ *Failure:* Automated copy of reference docs for ${{ steps.version-variables.outputs.minor }} failed. <${JOB_URL}|Review the workflow failure>"
+
+        curl \
+          -d "text=$MESSAGE" \
+          -d "channel=doctopus-tests" \
+          -d "token=${SLACK_BOT_TOKEN}" \
+          -X POST https://slack.com/api/chat.postMessage

changelog/v1.17.16/doc-fixes.yaml

@@ -0,0 +1,5 @@
+changelog:
+  - type: NON_USER_FACING
+    description: >-
+      Weekly doc fixes, including API proto doc format changes and an update to the copy-docs workflow.
+      skipCI-kube-tests:true