Part of #202.
Context
Operator-facing docs for the v1.2 GPU surface, plus the Helm values reference for periscope-gpu-agent.
Acceptance
Files this likely touches
- New:
docs/usage/gpu.md, docs/setup/gpu.md, docs/architecture/gpu-visibility.md
- Update:
docs/setup/cluster-rbac.md, docs/usage/meta.json, docs/setup/meta.json, docs/architecture/meta.json
- Update:
README.md
- Update:
scripts/sync-docs.mjs (if any path-rewriting is needed)
Dependencies
Land after the user-facing sub-tasks are mostly stable so screenshots don't churn.
Notes for contributors
- Match the voice + structure of
docs/usage/cve.md (Inspector v2 doc) — same operator-question shape, same screenshot rhythm
- The architecture doc is the public version of the private PRD; trim the strategic / hosted.ai bits, keep the technical sections
- Helm chart reference doc goes in
docs/setup/values.md (existing file)
Part of #202.
Context
Operator-facing docs for the v1.2 GPU surface, plus the Helm values reference for
periscope-gpu-agent.Acceptance
docs/usage/gpu.md— Pod↔GPU map walkthrough + Idle GPU finder + DCGM reconciler. Screenshots from the v1.2 capture session. Same structure asdocs/usage/cve.md.docs/setup/gpu.md— prerequisites (GPU Operator install, DCGM exporter, optional DRA driver), Helm values forperiscope-gpu-agent, IAM block needed for cluster-wide instance pricing reads (none — pricing is static), RBAC requirementsdocs/architecture/gpu-visibility.md— public version of the design memo (adapted from the private PRD). Covers the spine architecture, the four data sources, the per-node DaemonSet rationale, the DCGM reconciliation strategy.docs/setup/cluster-rbac.md— new section "GPU visibility (optional, v1.2+)" with the K8s RBAC + IAM additionsscripts/sync-docs.mjsneeds to know about the new doc pathsREADME.mdfeatures section with a GPU bulletFiles this likely touches
docs/usage/gpu.md,docs/setup/gpu.md,docs/architecture/gpu-visibility.mddocs/setup/cluster-rbac.md,docs/usage/meta.json,docs/setup/meta.json,docs/architecture/meta.jsonREADME.mdscripts/sync-docs.mjs(if any path-rewriting is needed)Dependencies
Land after the user-facing sub-tasks are mostly stable so screenshots don't churn.
Notes for contributors
docs/usage/cve.md(Inspector v2 doc) — same operator-question shape, same screenshot rhythmdocs/setup/values.md(existing file)