Skip to content

docs: define QA and support responsibility scope#92

Merged
ShortArrow merged 1 commit into
mainfrom
docs/qa-support-scope
Jul 24, 2026
Merged

docs: define QA and support responsibility scope#92
ShortArrow merged 1 commit into
mainfrom
docs/qa-support-scope

Conversation

@ShortArrow

Copy link
Copy Markdown
Owner

Summary

Fixes the previously implicit quality-assurance and service-responsibility boundary in one place.

  • ADR 0047 (Quality Assurance and Support Scope) — new:
    • Per-release verification matrix (native test + smoke per RID, both container arches, version guard) and the acknowledged gap (Integration suite is nightly, not a release gate).
    • Pre-1.0 compatibility contract: --json output schemas and the config.toml / scenario TOML schema are stable; breaking either requires a minor bump + explicit CHANGELOG entry. Everything else may change until 1.0.
    • Real-instrument policy: a point-in-time verified-instrument list (recorded version, no continuous re-verification — avoids an unbounded hardware matrix); unlisted instruments are best-effort standards conformance, bug reports with an IVICLI_CAPTURE log expected.
    • Support level: GitHub issues, best-effort, no SLA; latest release only, no backports.
  • SECURITY.md — private vulnerability reporting via the GitHub Security tab, latest-release-only fixes, and scope notes (loopback-default Management API, unauthenticated-by-design instrument protocols, mock container is a test fixture).
  • README (EN/JP) — user-facing "Support & quality" section with the verification summary, the compatibility promise, and the verified-instruments table (Kikusui PWR801L @ v0.2.6). Status line refreshed to v0.2.8.
  • CONTRIBUTING (EN/JP) — navigation-hub link to ADR 0047 / ADR 0016 / SECURITY.md.

Notes

Add ADR 0047 fixing the quality-assurance boundary: per-release
verification matrix, pre-1.0 compatibility contract (--json schemas
and config.toml are stable; breaks need a minor bump + CHANGELOG),
point-in-time verified-instrument list, and best-effort/latest-only
support. Add SECURITY.md (private vulnerability reporting, scope
notes). Surface the user-facing summary in README (EN/JP) with the
Kikusui PWR801L entry, and link the ADR from CONTRIBUTING (EN/JP).
Refresh the README status line to v0.2.8.
@ShortArrow
ShortArrow merged commit 83f51ce into main Jul 24, 2026
6 checks passed
@ShortArrow
ShortArrow deleted the docs/qa-support-scope branch July 24, 2026 04:32
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.

1 participant