Skip to content

Commit 9e5bb80

Browse files
authored
docs(cookbook): 📄 add readable a11y audit recipe diagram
This contribution introduces a resilient, stateless accessibility audit workflow tailored for GitHub Copilot. Key architectural highlights: - Shift-Left Approach: Performs WCAG 2.2 AAA audits directly at the Edge using a zero-framework Vanilla JS extractor. - Resource Efficiency: Optimized for degraded infrastructure and low-bandwidth scenarios, removing heavy dependencies like Playwright/Puppeteer. - Global Health Equity: Aligned with the BiotechProject mission to ensure digital accessibility in high-latency or resource-constrained global health environments. Includes a Mermaid architectural diagram for clear visualization of the data flow from the stateless browser to Copilot's agentic reasoning.
1 parent cbbcac0 commit 9e5bb80

1 file changed

Lines changed: 38 additions & 1 deletion

File tree

cookbook/resilient-edge-audit/README.md

Lines changed: 38 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,8 +2,45 @@
22

33
This recipe demonstrates how to perform accessibility audits using GitHub Copilot in environments with **degraded infrastructure** or **low bandwidth**.
44

5+
<details>
6+
<summary>🔍 View Architectural Workflow Diagram</summary>
7+
8+
```mermaid
9+
graph TD
10+
%% Struttura dei nodi
11+
subgraph Browser["🌍 Browser (Stateless Edge)"]
12+
VanillaJS["Minimalist JS Injector"]
13+
DOM["DOM Atoms (Semantics)"]
14+
end
15+
16+
subgraph Network["Low-Bandwidth / Degraded Net"]
17+
DataJSON["Ultralight JSON Payload"]
18+
end
19+
20+
subgraph AI["GitHub Copilot (SRE Optimized)"]
21+
AuditAI["Copilot WCAG 2.2 AAA Audit"]
22+
FixAI["High-Resilience Fixes"]
23+
end
24+
25+
%% Connessioni del Workflow
26+
VanillaJS -->|1. Extract| DOM
27+
DOM -->|2. Serialize| DataJSON
28+
DataJSON -->|3. Transfer| AuditAI
29+
AuditAI -->|4. Analyze| FixAI
30+
31+
%% Styling Accessibile (Bordi spessi, colori neutri ad alto contrasto)
32+
classDef browser stroke:#2196f3,stroke-width:2px;
33+
classDef network stroke:#fbc02d,stroke-width:2px,stroke-dasharray: 5 5;
34+
classDef ai stroke:#4caf50,stroke-width:2px;
35+
36+
class Browser,VanillaJS,DOM browser;
37+
class Network,DataJSON network;
38+
class AI,AuditAI,FixAI ai;
39+
```
40+
</details>
41+
542
## Context
6-
Standard accessibility tools often require heavy dependencies (Playwright, Puppeteer). In global health equity scenarioscore to the **BiotechProject** visionwe need a "Zero-Framework" approach that runs entirely at the Edge.
43+
Standard accessibility tools often require heavy dependencies (Playwright, Puppeteer). In global health equity scenarios - core to the **BiotechProject** vision, we need a "Zero-Framework" approach that runs entirely at the Edge.
744

845
## The Recipe
946
1. **Extract:** Use a minimalist Vanilla JS script to snapshot the semantic DOM.

0 commit comments

Comments
 (0)