Skip to content

docs: Documentation analysis and improvement#1026

Draft
github-actions[bot] wants to merge 1 commit into
mainfrom
docs/buildkite-secret-docs-1025-8cede2639487a131
Draft

docs: Documentation analysis and improvement#1026
github-actions[bot] wants to merge 1 commit into
mainfrom
docs/buildkite-secret-docs-1025-8cede2639487a131

Conversation

@github-actions
Copy link
Copy Markdown
Contributor

Closes #1025

Summary of files analyzed

  • .github/workflows/oblt-aw-ingress.yml
  • .github/workflows/gh-aw-estc-pr-buildkite-detective.yml
  • .github/remote-workflow-template/obs/.github/workflows/oblt-aw.yml
  • docs/workflows/oblt-aw-client-template.md
  • docs/workflows/gh-aw-estc-pr-buildkite-detective.md
  • docs/workflows/oblt-aw-ingress.md

Issues found

  • docs/workflows/oblt-aw-client-template.md: stated ingress skips Buildkite detective when the secret is absent.
  • .github/workflows/oblt-aw-ingress.yml: routing condition for estc-pr-buildkite-detective is based on failed Buildkite status context and dashboard gate only; no secret-presence check is part of routing.
  • .github/workflows/gh-aw-estc-pr-buildkite-detective.yml: workflow_call requires BUILDKITE_API_TOKEN, so missing secret mapping causes contract failure.

Changes made

  • docs/workflows/oblt-aw-client-template.md: replaced the inaccurate “ingress skips the job when absent” claim with explicit required-secret behavior for failed Buildkite status events.
    • Rationale: align client-template docs with actual ingress routing and downstream required secret contract.
  • docs/workflows/gh-aw-estc-pr-buildkite-detective.md: added explicit note that ingress routing does not validate secret presence and that missing BUILDKITE_LOGS_API_TOKEN mapping prevents the required workflow_call secret contract from being satisfied.
    • Rationale: make operator-facing prerequisite behavior explicit where the detective workflow is documented.

What is this? | From workflow: Observability Agentic Workflow Entrypoint

Give us feedback! React with 🚀 if perfect, 👍 if helpful, 👎 if not.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[oblt-aw][autodoc] Correct Buildkite secret behavior in client-template workflow docs

0 participants