"Explain Like I'm New" / Plain Language Toggle

Module

Web

Status

VERIFIED

Description

Toggle between technical and plain language modes with Alt+P shortcut, glossary tooltip directive for jargon expansion, and dedicated service for managing the state. Originally marked TODO in advisory but now implemented.

Implementation Details

Feature directory: src/Web/StellaOps.Web/src/app/shared/components/plain-language-toggle/
Components:
- plain-language-toggle (src/Web/StellaOps.Web/src/app/shared/components/plain-language-toggle/plain-language-toggle.component.ts)
Source: Feature matrix scan

E2E Test Plan

Setup:
- Log in with a user that has appropriate permissions
- Navigate to the relevant page/section where this feature appears
- Ensure test data exists (scanned artifacts, SBOM data, or seed data as needed)
Core verification:
- Verify the component renders correctly with sample data
- Verify interactive elements respond to user input
- Verify data is fetched and displayed from the correct API endpoints
Edge cases:
- Verify graceful handling when backend API is unavailable (error state)
- Verify responsive layout at different viewport sizes
- Verify accessibility (keyboard navigation, screen reader labels, ARIA attributes)

Verification

Run: docs/qa/feature-checks/runs/web/explain-like-i-m-new-plain-language-toggle/run-001/
Tier 0 (source): pass (tier0-source-check.json)
Tier 1 (build/tests): pass (tier1-build-check.json)
Tier 2 (behavior): pass (tier2-e2e-check.json)
Verified on (UTC): 2026-02-11

1.6 KiB Raw Blame History