Skip to content

docs: Documentation analysis and improvement#1116

Draft
github-actions[bot] wants to merge 1 commit into
mainfrom
docs/issue-1115-unified-entrypoint-docs-106982298f04c039
Draft

docs: Documentation analysis and improvement#1116
github-actions[bot] wants to merge 1 commit into
mainfrom
docs/issue-1115-unified-entrypoint-docs-106982298f04c039

Conversation

@github-actions

@github-actions github-actions Bot commented Jun 3, 2026

Copy link
Copy Markdown
Contributor

Closes #1115

Summary of files analyzed

  • .github/remote-workflow-template/obs/.github/workflows/trigger-oblt-aw.yml
  • .github/remote-workflow-template/obs/.github/workflows/oblt-aw.yml
  • .github/remote-workflow-template/docs/.github/workflows/trigger-docs-aw.yml
  • .github/remote-workflow-template/docs/.github/workflows/docs-aw.yml
  • docs/onboarding/README.md
  • docs/onboarding/adopting-agentic-workflows.md
  • docs/onboarding/registering-a-repository.md
  • docs/workflows/oblt-aw-client-template.md
  • docs/workflows/docs-aw-client-template.md

Issues found

  • docs/onboarding/README.md: Overview still described distributed per-workflow trigger-oblt-aw-*.yml model.
  • docs/onboarding/adopting-agentic-workflows.md: Adoption flow and checklist referenced split per-workflow trigger files and removal of oblt-aw.yml.
  • docs/onboarding/registering-a-repository.md: workflow_ref examples and migration guidance referenced obsolete per-workflow trigger files; troubleshooting referenced outdated job name.
  • docs/workflows/oblt-aw-client-template.md: Permission table listed actions: write for oblt-aw.yml ingress, but template uses actions: read.
  • docs/workflows/docs-aw-client-template.md: Permission table listed id-token: write for docs-aw.yml, but template does not declare it.

Changes made

  • Updated docs/onboarding/README.md to describe the unified observability client entrypoint model (trigger-oblt-aw.yml + oblt-aw.yml) so onboarding aligns with current distribution templates.
  • Updated docs/onboarding/adopting-agentic-workflows.md to:
    • describe the unified trigger-oblt-aw.ymloblt-aw.ymloblt-aw-ingress.yml flow,
    • remove guidance to create per-workflow trigger client files,
    • replace incorrect removal guidance (oblt-aw.yml) with removal of legacy trigger-oblt-aw-*.yml files.
  • Updated docs/onboarding/registering-a-repository.md to:
    • switch workflow_ref examples to elastic/<repo>/.github/workflows/oblt-aw.yml@refs/heads/main,
    • align distribution verification with unified client files,
    • update troubleshooting to reference the current ingress job naming.
  • Updated docs/workflows/oblt-aw-client-template.md permission matrix to actions: read for oblt-aw.yml ingress, matching template YAML.
  • Updated docs/workflows/docs-aw-client-template.md permission matrix to remove id-token: write for docs-aw.yml, matching template YAML.

These are doc-only, high-confidence updates grounded in current template workflow sources.


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] Update onboarding and client-template docs for unified entrypoint model and current permissions

0 participants