Skip to content

docs(i18n): translate governance specifications and QA test guides to english - #11

Merged
nicolasvd merged 2 commits into
mainfrom
docs/issue-10-i18n-governance-docs
Sep 25, 2026
Merged

nicolasvd merged 2 commits into
mainfrom
docs/issue-10-i18n-governance-docs

Conversation

@nicolasvd

@nicolasvd nicolasvd commented Sep 25, 2026 •

Copy link
Copy Markdown
Owner

Closes #10

📌 Summary

Branch: docs/issue-10-i18n-governance-docs → main
Type: docs(i18n)
Related Issue: #10 docs(i18n): translate governance specifications and QA test guides to english
Parent Epic: #7 epic(i18n): establish unified english-first technical and governance baseline

  • Translated docs/scripts-reference.md (vision, script index, reference sheets, CLI options, and composition matrix) to English (L-02).
  • Translated and generalized docs/qa-classification-test-guide.md (P0/P1/P2 defect severity matrix, 3-State Access QA protocols, Two-Tier hybrid AI architecture, and golden test qualification patterns) to English (L-04).
  • Translated and generalized docs/analytics-taxonomy.md (Zero-PII privacy principles, canonical user properties, and functional event catalog across AI, entity lifecycle, priority, duo sync, and settings) to English (L-02).
  • Stripped all application-specific legacy entities (Second Brain) to establish a truly generic architectural baseline for the Agentic Android Delivery Kernel.
  • Preserved all cross-links, markdown structures, and strict byte budgets.

📂 Affected Files

File Diff Role
docs/scripts-reference.md +107 -122 Comprehensive scripts reference and automation architecture
docs/qa-classification-test-guide.md +72 -60 Generic QA testing guide and Two-Tier AI qualification reference
docs/analytics-taxonomy.md +76 -65 Generic Zero-PII analytics taxonomy and telemetry contract

✅ Quality Airbag — ./scripts/quality-check.sh

Check Result
Kotlin / Java compilation ✅ 0 errors
Android Lint (debug) ✅ 0 warnings
Android Lint (release) ✅ 0 warnings
Unit tests & Roborazzi ✅ Passed (0 failures)
Runtime Guardrails (test-runtime-guardrails.mjs) ✅ 18/18 passed
Documentation contracts (validate-docs.sh) ✅ 38/38 contracts valid & within budget

⚡ FinOps & Agent Efficiency

Metric Measurement Status
Conversation turns 4 turns ✅ Optimal (< 20)
Circuit Breaker 0 trip (max 3 iterations) ✅ Passed · No loop
Context Hygiene Clean persona transitions ✅ Compliant
Rule 0.1 Gating Decomposed under Parent Epic #7 (atomic documentation PR) ✅ Compliant

📸 UI Snapshots / Roborazzi Visual Diffs

N/A — No UI composable or visual changes in this documentation story.


Caution

Zero Auto-Merge — Explicit approval required.
This PR will NOT be merged until the author explicitly confirms: "Tu peux merger" or equivalent.
P6 presents this PR link and stops. Merge is a deliberate human action.

… english

- Translate docs/scripts-reference.md operational and architectural guide to English (L-02)
- Translate docs/qa-classification-test-guide.md test matrix and philosophy to English (L-04)
- Translate docs/analytics-taxonomy.md event catalog and Zero-PII policies to English (L-02)

Closes #10
@nicolasvd nicolasvd added documentation Improvements or additions to documentation skip-release Skip APK artifact release and distribution scope:i18n labels Sep 25, 2026
…l reuse

- Generalize docs/analytics-taxonomy.md into canonical Zero-PII kernel contract
- Generalize docs/qa-classification-test-guide.md to Two-Tier AI and 3-State QA reference
- Remove project-specific Second Brain entity and test strings

Ref #10
@nicolasvd
nicolasvd merged commit 647d38f into main Sep 25, 2026
3 checks passed
@nicolasvd
nicolasvd deleted the docs/issue-10-i18n-governance-docs branch September 25, 2026 16:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation scope:i18n skip-release Skip APK artifact release and distribution

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs(i18n): translate governance specifications and QA test guides to english

1 participant