Files
summercms/.planning/phases/11.1-summercms-documentation-for-humans-and-ai-agents/11.1-UAT.md
2026-10-01 09:36:25 +02:00

53 lines
2.1 KiB
Markdown

---
status: testing
phase: 11.1-summercms-documentation-for-humans-and-ai-agents
source: [11.1-VERIFICATION.md]
started: 2026-10-01T07:36:12Z
updated: 2026-10-01T07:36:12Z
---
## Current Test
number: 1
name: Run summer docs:serve, open the printed address, search for a module name and a CLI command, and use the arrow keys and Enter.
expected: |
Rows show section, title, heading and a 2-line excerpt with mark highlights; arrow keys move the selection and Enter opens the page; the live region announces the count; empty and zero-result states show the UI-SPEC copy.
awaiting: user response
## Tests
### 1. Run summer docs:serve, open the printed address, search for a module name and a CLI command, and use the arrow keys and Enter.
expected: Rows show section, title, heading and a 2-line excerpt with mark highlights; arrow keys move the selection and Enter opens the page; the live region announces the count; empty and zero-result states show the UI-SPEC copy.
result: [pending]
### 2. Cycle the theme toggle through light, dark and system, reload in each mode, and check a guide page and an API page at 1280px, 1024px and 375px.
expected: No flash of the wrong theme; the choice persists; UI-SPEC contrast pairs hold in both themes.
result: [pending]
### 3. Disable JavaScript and load a guide page below 1024px.
expected: The sidebar renders above the content and the search and theme buttons are hidden.
result: [pending]
### 4. Read llms.txt, one page .md and llms-full.txt as an agent would.
expected: Spec shape with predictable .md URLs that are useful without HTML.
result: [pending]
### 5. Read Setup, Backend, Database and Services, and follow docs/setup/porting-a-plugin.md top to bottom.
expected: WinterCMS docs tone, accurate to the module READMEs, ending at the same acme.blog plugin as docs/examples/blog.
result: [pending]
### 6. Resolve the seven judgment-tier prohibitions in the report body.
expected: Each holds. The verifier's non-authoritative verdict is holds for all seven.
result: [pending]
## Summary
total: 6
passed: 0
issues: 0
pending: 6
skipped: 0
blocked: 0
## Gaps