docs: route docs build alerts to #docs-alerts (#23293)

Switch docs CI Slack notifications from `#devrel-docs-updates` to
`#docs-alerts`.

Updated channel references in:
- `docs/bootstrap.sh` (doc reference check failure alert)
- `docs/examples/bootstrap.sh` (default channel for
`send_slack_message`)
- `docs/scripts/check_doc_references.sh` (doc-references PR notification
+ `SLACK_DOC_UPDATE_CHANNEL` default)
- `docs/scripts/validate_api_ref_links.sh` (API ref link validation
alert)

Requested by Josh Crites in #docs-alerts.

---
*Created by
[claudebox](https://claudebox.work/v2/sessions/ed31fdd79c7253b6) ·
group: `slackbot`*

Author: ludamad

.github/workflows/ci3.yml

@@ -96,6 +96,8 @@ jobs:
           NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
           CARGO_REGISTRY_TOKEN: ${{ secrets.CARGO_REGISTRY_TOKEN }}
           SLACK_BOT_TOKEN: ${{ secrets.SLACK_BOT_TOKEN }}
+          # Used by docs CI scripts to post to #docs-alerts (the SLACK_BOT_TOKEN bot lacks access there).
+          AZTEC_FOUNDATION_CI_SLACK_BOT_TOKEN: ${{ secrets.AZTEC_FOUNDATION_CI_SLACK_BOT_TOKEN }}
           AZTEC_TOOLCHAIN_DEFAULT_MAJOR_VERSION: ${{ vars.AZTEC_TOOLCHAIN_DEFAULT_MAJOR_VERSION }}
           # For automatic documentation updates via Claude Code
           ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}

docs/README.md

@@ -577,20 +577,20 @@ Building on the DevRel review automation, the docs CI can analyze PRs and notify
    - Generate suggested documentation changes
 
 3. **Slack Notification**: If documentation updates are suggested:
-   - A message is sent to the configured Slack channel (default: `#devrel`)
+   - A message is sent to the configured Slack channel (default: `#docs-alerts`)
    - The message includes the PR details, affected docs, and suggested changes
    - The DevRel team can review and apply the changes manually
 
 **Requirements**:
 
 - `ANTHROPIC_API_KEY` must be set in CI secrets
-- `SLACK_BOT_TOKEN` must be set for Slack notifications
+- `AZTEC_FOUNDATION_CI_SLACK_BOT_TOKEN` must be set for Slack notifications (this bot has access to `#docs-alerts`)
 - Claude Code CLI must be installed (`@anthropic-ai/claude-code`)
 - The PR must not be a draft
 
 **Environment Variables**:
 
-- `SLACK_DOC_UPDATE_CHANNEL` - Slack channel for notifications (default: `#devrel`)
+- `SLACK_DOC_UPDATE_CHANNEL` - Slack channel for notifications (default: `#docs-alerts`)
 - `DRY_RUN=1` - Skip Slack notification, just print what would be sent
 
 **Implementation**: The automation is handled by `scripts/check_doc_references.sh`, which detects changed references, requests devrel review, sends a Slack notification, and dispatches ClaudeBox — all in a single pass.

docs/bootstrap.sh

@@ -61,11 +61,11 @@ function check_references {
   echo_header "Check doc references"
   if ! ./scripts/check_doc_references.sh docs; then
     echo "⚠ Doc reference check failed (non-blocking)."
-    if [[ -n "${SLACK_BOT_TOKEN:-}" ]]; then
+    if [[ -n "${AZTEC_FOUNDATION_CI_SLACK_BOT_TOKEN:-}" ]]; then
       curl -s -X POST https://slack.com/api/chat.postMessage \
-        -H "Authorization: Bearer $SLACK_BOT_TOKEN" \
+        -H "Authorization: Bearer $AZTEC_FOUNDATION_CI_SLACK_BOT_TOKEN" \
         -H "Content-type: application/json" \
-        -d "{\"channel\": \"#devrel-docs-updates\", \"text\": \"⚠️ Doc reference check script failed for ref \`${GITHUB_REF_NAME:-unknown}\`. Check CI logs.\"}" \
+        -d "{\"channel\": \"#docs-alerts\", \"text\": \"⚠️ Doc reference check script failed for ref \`${GITHUB_REF_NAME:-unknown}\`. Check CI logs.\"}" \
         > /dev/null 2>&1 || true
     fi
   fi

docs/examples/bootstrap.sh

@@ -237,9 +237,9 @@ function get_pr_number {
 
 function send_slack_message {
   local message=$1
-  local channel=${2:-"#devrel-docs-updates"}
-  if [[ -z "${SLACK_BOT_TOKEN:-}" ]]; then
-    echo "SLACK_BOT_TOKEN not set, skipping Slack notification"
+  local channel=${2:-"#docs-alerts"}
+  if [[ -z "${AZTEC_FOUNDATION_CI_SLACK_BOT_TOKEN:-}" ]]; then
+    echo "AZTEC_FOUNDATION_CI_SLACK_BOT_TOKEN not set, skipping Slack notification"
     return 0
   fi
 
@@ -249,7 +249,7 @@ function send_slack_message {
 
   local response
   if ! response=$(curl -s --fail-with-body -X POST https://slack.com/api/chat.postMessage \
-    -H "Authorization: Bearer $SLACK_BOT_TOKEN" \
+    -H "Authorization: Bearer $AZTEC_FOUNDATION_CI_SLACK_BOT_TOKEN" \
     -H "Content-type: application/json" \
     --data "$data"); then
     echo "Slack API request failed (curl error)" >&2

docs/scripts/check_doc_references.sh

@@ -7,7 +7,7 @@ set -euo pipefail
 # 1. Extracts all 'references' fields from documentation markdown frontmatter
 # 2. Checks if any referenced files were changed in the current PR
 # 3. Requests AztecProtocol/devrel team as reviewers if files changed and PR is not draft
-# 4. Sends a Slack message to #devrel-docs-updates showing which changed files are referenced by which docs
+# 4. Sends a Slack message to #docs-alerts showing which changed files are referenced by which docs
 # 5. Dispatches ClaudeBox to analyze changes and update documentation
 # 6. Skips reviewer request if devrel team is already requested or a member has approved
 #
@@ -25,7 +25,7 @@ set -euo pipefail
 #   GITHUB_REF - May contain PR number in format refs/pull/123/merge
 #   GITHUB_BASE_REF - Base branch name (set by GitHub Actions)
 #   GITHUB_TOKEN - GitHub token for gh CLI (set by GitHub Actions)
-#   SLACK_BOT_TOKEN - Required for sending Slack messages
+#   AZTEC_FOUNDATION_CI_SLACK_BOT_TOKEN - Required for sending Slack messages (has #docs-alerts access)
 #   CI - Set to 1 in CI environment
 
 # Only run in CI environment to avoid accidental local execution
@@ -37,21 +37,21 @@ fi
 # Function to send Slack message
 send_slack_message() {
   local message=$1
-  if [[ -z "${SLACK_BOT_TOKEN:-}" ]]; then
-    echo "SLACK_BOT_TOKEN not set, skipping Slack notification"
+  if [[ -z "${AZTEC_FOUNDATION_CI_SLACK_BOT_TOKEN:-}" ]]; then
+    echo "AZTEC_FOUNDATION_CI_SLACK_BOT_TOKEN not set, skipping Slack notification"
     return 0
   fi
 
   local data=$(cat <<EOF
 {
-  "channel": "#devrel-docs-updates",
+  "channel": "#docs-alerts",
   "text": "$message"
 }
 EOF
 )
   local response
   if ! response=$(curl -s --fail-with-body -X POST https://slack.com/api/chat.postMessage \
-    -H "Authorization: Bearer $SLACK_BOT_TOKEN" \
+    -H "Authorization: Bearer $AZTEC_FOUNDATION_CI_SLACK_BOT_TOKEN" \
     -H "Content-type: application/json" \
     --data "$data"); then
     echo "Slack API request failed (curl error)" >&2
@@ -352,11 +352,11 @@ else
 fi
 
 # Send or update Slack notification (one message per PR, updated on each run)
-SLACK_CHANNEL="${SLACK_DOC_UPDATE_CHANNEL:-devrel-docs-updates}"
+SLACK_CHANNEL="${SLACK_DOC_UPDATE_CHANNEL:-docs-alerts}"
 TS=""
 CHANNEL_ID=""
 
-if [[ -n "${SLACK_BOT_TOKEN:-}" ]]; then
+if [[ -n "${AZTEC_FOUNDATION_CI_SLACK_BOT_TOKEN:-}" ]]; then
   # Build the Slack message
   NOW=$(date -u '+%Y-%m-%d %H:%M UTC')
   SLACK_MESSAGE="📚 *Documentation References Updated*\\n\\nThe following source files changed in <$PR_URL|PR #$PR_NUMBER> are referenced by documentation:\\n"
@@ -381,7 +381,7 @@ if [[ -n "${SLACK_BOT_TOKEN:-}" ]]; then
 
   # Look up channel ID
   CHANNEL_ID=$(curl -sS "https://slack.com/api/conversations.list?types=public_channel&limit=200" \
-    -H "Authorization: Bearer $SLACK_BOT_TOKEN" | jq -r ".channels[] | select(.name==\"$SLACK_CHANNEL\") | .id" 2>/dev/null || echo "")
+    -H "Authorization: Bearer $AZTEC_FOUNDATION_CI_SLACK_BOT_TOKEN" | jq -r ".channels[] | select(.name==\"$SLACK_CHANNEL\") | .id" 2>/dev/null || echo "")
 
   if [[ -n "$CHANNEL_ID" ]]; then
     # Search channel history for an existing message about this PR (paginate up to 1000 messages)
@@ -393,7 +393,7 @@ if [[ -n "${SLACK_BOT_TOKEN:-}" ]]; then
       HISTORY_URL="https://slack.com/api/conversations.history?channel=$CHANNEL_ID&limit=200"
       [[ -n "$CURSOR" ]] && HISTORY_URL="${HISTORY_URL}&cursor=$CURSOR"
 
-      HISTORY_RESP=$(curl -sS "$HISTORY_URL" -H "Authorization: Bearer $SLACK_BOT_TOKEN")
+      HISTORY_RESP=$(curl -sS "$HISTORY_URL" -H "Authorization: Bearer $AZTEC_FOUNDATION_CI_SLACK_BOT_TOKEN")
 
       EXISTING_TS=$(echo "$HISTORY_RESP" | \
         jq -r ".messages[]? | select(.text != null and .bot_id != null and (.text | contains(\"PR #$PR_NUMBER\"))) | .ts" 2>/dev/null | head -1 || echo "")
@@ -407,7 +407,7 @@ if [[ -n "${SLACK_BOT_TOKEN:-}" ]]; then
       # Update existing message
       echo "Updating existing Slack message for PR #$PR_NUMBER..."
       RESP=$(curl -sS -X POST https://slack.com/api/chat.update \
-        -H "Authorization: Bearer $SLACK_BOT_TOKEN" \
+        -H "Authorization: Bearer $AZTEC_FOUNDATION_CI_SLACK_BOT_TOKEN" \
         -H "Content-type: application/json" \
         -d "$(jq -n --arg c "$CHANNEL_ID" --arg ts "$EXISTING_TS" --arg t "$SLACK_MESSAGE" \
           '{channel:$c, ts:$ts, text:$t}')")
@@ -416,7 +416,7 @@ if [[ -n "${SLACK_BOT_TOKEN:-}" ]]; then
       # Post new message
       echo "Sending Slack notification to #${SLACK_CHANNEL}..."
       RESP=$(curl -sS -X POST https://slack.com/api/chat.postMessage \
-        -H "Authorization: Bearer $SLACK_BOT_TOKEN" \
+        -H "Authorization: Bearer $AZTEC_FOUNDATION_CI_SLACK_BOT_TOKEN" \
         -H "Content-type: application/json" \
         -d "$(jq -n --arg c "$CHANNEL_ID" --arg t "$SLACK_MESSAGE" '{channel:$c, text:$t}')")
       TS=$(echo "$RESP" | jq -r '.ts // empty')
@@ -433,5 +433,5 @@ if [[ -n "${SLACK_BOT_TOKEN:-}" ]]; then
     echo "⚠ Could not find Slack channel #$SLACK_CHANNEL"
   fi
 else
-  echo "SLACK_BOT_TOKEN not set, skipping Slack notification"
+  echo "AZTEC_FOUNDATION_CI_SLACK_BOT_TOKEN not set, skipping Slack notification"
 fi

docs/scripts/validate_api_ref_links.sh

@@ -211,22 +211,22 @@ get_pr_context() {
   fi
 }
 
-# Send a Slack message to #devrel-docs-updates
+# Send a Slack message to #docs-alerts
 # Args: $1 = message text
 send_slack_message() {
   local message=$1
-  if [[ -z "${SLACK_BOT_TOKEN:-}" ]]; then
-    echo "SLACK_BOT_TOKEN not set, skipping Slack notification"
+  if [[ -z "${AZTEC_FOUNDATION_CI_SLACK_BOT_TOKEN:-}" ]]; then
+    echo "AZTEC_FOUNDATION_CI_SLACK_BOT_TOKEN not set, skipping Slack notification"
     return 0
   fi
 
   local data
-  data=$(jq -n --arg channel "#devrel-docs-updates" --arg text "$message" \
+  data=$(jq -n --arg channel "#docs-alerts" --arg text "$message" \
     '{channel: $channel, text: $text}')
 
   local response
   if ! response=$(curl -s --fail-with-body -X POST https://slack.com/api/chat.postMessage \
-    -H "Authorization: Bearer $SLACK_BOT_TOKEN" \
+    -H "Authorization: Bearer $AZTEC_FOUNDATION_CI_SLACK_BOT_TOKEN" \
     -H "Content-type: application/json" \
     --data "$data"); then
     echo "Slack API request failed (curl error)" >&2
@@ -292,7 +292,7 @@ send_alert() {
   message+=$'\n'"*Action required:* Run \`yarn generate:aztec-nr-api\` and/or \`yarn generate:typescript-api\` to regenerate the API docs."
 
   if send_slack_message "$message"; then
-    echo "Slack notification sent to #devrel-docs-updates."
+    echo "Slack notification sent to #docs-alerts."
   else
     echo "WARNING: Failed to send Slack notification." >&2
   fi