Skip to content

docs: make the architecture diagram readable and repair a page heading - #614

Open
imran-siddique wants to merge 2 commits into
mainfrom
docs/readable-diagram
Open

docs: make the architecture diagram readable and repair a page heading#614
imran-siddique wants to merge 2 commits into
mainfrom
docs/readable-diagram

Conversation

@imran-siddique

@imran-siddique imran-siddique commented Sep 6, 2026

Copy link
Copy Markdown
Member

The deployed architecture diagram shrinks its labels on mobile. Wrap it in a labeled, keyboard-focusable horizontal scroll region using the shared diagram styles. Also keep the #461 issue reference inside its hardware-validation paragraph, where it previously became a second H1.

Validation: strict MkDocs build and CI docs-check pass. The current full CI run fails 20 runtime tests around Agent Manifest verification and a TPM error string; it is not ready to merge. On clean main 6e5d0ce with agent-manifest 0.12.0, the targeted Manifest/TPM tests reproduce 9 failures and 10 passes. This branch changes only two documentation pages.

@imran-siddique
imran-siddique requested a review from a team as a code owner September 6, 2026 01:55
@imran-siddique

Copy link
Copy Markdown
Member Author

@agentrust-io/maintainers please review this PR and submit an approving review if the changes look correct. All checks are green; maintainer approval is still required to merge.

This keeps the architecture diagram readable on small screens with a labeled, keyboard-focusable horizontal scroll region. The shared contrast styles have merged, and the local preview was checked in both themes.

Signed-off-by: Imran Siddique <imran.siddique@opaque.co>
@imran-siddique imran-siddique changed the title docs: keep architecture labels readable on narrow screens docs: make the architecture diagram readable and repair a page heading Sep 6, 2026
@imran-siddique

Copy link
Copy Markdown
Member Author

CI blocker reproduced on clean main 6e5d0ce: tests/unit/test_agent_manifest.py and tests/unit/test_tpm_chained_verify.py give 19 passed with agent-manifest 0.11.2, versus 9 failed and 10 passed with 0.12.0. The latter failures match the Manifest MISMATCH and TPM message failures in this PR run. The branch changes only two documentation pages and docs-check passes. Please keep this unmerged until compatibility with the new SDK is resolved.

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