Skip to content

Document SRE Agent investigation workflows and mitigation playbooks in README, and add Arabic translation - #2

Draft
AlahmadiQ8 with Copilot wants to merge 4 commits into
mainfrom
copilot/update-readme
Draft

Document SRE Agent investigation workflows and mitigation playbooks in README, and add Arabic translation#2
AlahmadiQ8 with Copilot wants to merge 4 commits into
mainfrom
copilot/update-readme

Conversation

Copilot AI commented Jun 18, 2026

Copy link
Copy Markdown

The README contained two empty TODO placeholders (Investigation Workflows, Mitigation Playbooks) and lacked top-level navigation. This fills those gaps with documentation derived directly from the codebase, and adds a full Arabic translation.

Changes

  • Investigation Workflows — Per-scenario table mapping each of the 8 chaos scenarios to its alert(s) (A1A10), primary telemetry signal, and a distinguishing clue (e.g. Slow API vs. CPU/memory saturation). Includes a 4-step investigation guide and an example KQL query keyed off the ChaosScenario activated log marker.
  • Mitigation Playbooks — Documents the self-healing 5-minute auto-recovery (CancellationTokenSource / DefaultDuration), the memory-leak caveat (GC may not reclaim until process restart), and a guaranteed clean-reset command.
  • Table of Contents — Added for navigating the long README.
  • Reset command — Parameterized the hardcoded resource group into RG_NAME to avoid copy-paste errors.
  • Arabic (العربية) section — Added a full Arabic translation with RTL layout (<div dir="rtl">), covering architecture, tech stack, prerequisites, quick start, chaos scenarios, SRE Agent setup, tests, and cleanup, plus a language selector at the top linking between English and Arabic.

Content is sourced from ChaosService.cs, infra/modules/alerts.bicep, and the custom ContosoBank meter; internal links to DEMO.md anchors are verified. Documentation-only — no source code touched.

Copilot AI changed the title [WIP] Update README documentation for better clarity Document SRE Agent investigation workflows and mitigation playbooks in README Jun 18, 2026
Copilot AI requested a review from AlahmadiQ8 June 18, 2026 09:03
@AlahmadiQ8

Copy link
Copy Markdown
Owner

@copilot update the readme to include full Arabic section.

Copilot AI commented Jun 18, 2026

Copy link
Copy Markdown
Author

@copilot update the readme to include full Arabic section.

Added a full Arabic (العربية) section to the README with RTL layout, covering architecture, tech stack, prerequisites, quick start, chaos scenarios, SRE Agent setup, tests, and cleanup. Also added a language selector at the top linking between English and Arabic. Done in commit 03c92ef.

@copilot update the readme to include full Arabic section.

Correction: the Arabic section was added in commit 819dcc2.

Copilot AI changed the title Document SRE Agent investigation workflows and mitigation playbooks in README Document SRE Agent investigation workflows and mitigation playbooks in README, and add Arabic translation Jun 18, 2026
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.

2 participants