Skip to content

docs: Documentation analysis and improvement#834

Draft
github-actions[bot] wants to merge 1 commit intomainfrom
docs-issue-833-46269fff82724302
Draft

docs: Documentation analysis and improvement#834
github-actions[bot] wants to merge 1 commit intomainfrom
docs-issue-833-46269fff82724302

Conversation

@github-actions
Copy link
Copy Markdown
Contributor

@github-actions github-actions Bot commented May 9, 2026

Closes #833

Summary of files analyzed

  • .github/workflows/oblt-aw-ingress.yml (detector routing condition)
  • docs/workflows/gh-aw-resource-not-accessible-by-integration-detector.md
  • docs/architecture/multi-org-agentic-workflows.md
  • scripts/common.py
  • scripts/sync_control_plane_dashboard.py
  • scripts/get_enabled_workflows.py
  • tests/test_get_enabled_workflows.py
  • tests/test_sync_control_plane_dashboard.py

Issues found

  • docs/workflows/gh-aw-resource-not-accessible-by-integration-detector.md: stated detector is routed by ingress on schedule or workflow_dispatch, but ingress routes this detector only when github.event_name == schedule.
  • docs/architecture/multi-org-agentic-workflows.md: mixed current-state language with stale migration instructions that described already-completed parser/gating/test work as pending.

Changes made

  • Updated docs/workflows/gh-aw-resource-not-accessible-by-integration-detector.md to document the actual ingress routing behavior (schedule only), preventing trigger confusion during operations.
  • Updated docs/architecture/multi-org-agentic-workflows.md to replace stale “must be updated” wording with implemented-state wording, including explicit note about legacy two-part marker compatibility.
  • Replaced the migration “sketch” section with migration status statements that reflect current repository behavior (org-aware markers, compound IDs, merged dashboard sync, ingress gating, and existing test coverage), so contributors are not directed to redo completed work.

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] Fix docs drift in detector trigger and multi-org migration status

0 participants