docs: fill journeydoc tutorials#72
Merged
Merged
Conversation
Filled in all 11 journeydoc tutorials with real prose (8 user-track +
3 admin-track), wired up the capture spec end-to-end, and committed
the 54 screenshots produced by a clean docs-capture run against the
local dev container.
Pages:
- user/01-first-launch — open Scholiq, walk the nav, confirm OR wiring
- user/02-create-course — Courses → Add Item dialog, save, open detail
- user/03-enrol-students — individual + Bulk-enrol from cohort/CSV
- user/04-assignments — publish brief, accept submissions, mark
- user/05-attendance — mark a session, roll-up to learner profile
- user/06-grading — grade entries → final grade + RS256 publish
- user/07-issue-certificate — verifiable credential + public verifier
- user/08-track-progress — Learner profile tabs (enrolments, grades,
attendance, credentials, logs)
- admin/01-school-structure — programmes + cohorts + timetables
- admin/02-compliance-audit — signed audit-pack ZIP via Data exchange
- admin/03-admin-settings — register import, AI features, signing key
Capture spec: real flows via /apps/scholiq/{courses,enrolments,...}
with shoot() / dismissOverlays() / go() / captureCreateDialog()
helpers cloned from the decidesk pilot. Empty-state fallbacks where
seed data is not yet importable (OpenRegister register-import gap
openregister#1487).
Docs build verified locally: 11/11 capture tests pass, npm run build
in docs/ ends with [SUCCESS] (only the expected /privacy /terms /iso
footer warnings).
Contributor
Quality Report — ConductionNL/scholiq @
|
| Check | PHP | Vue | Security | License | Tests |
|---|---|---|---|---|---|
| lint | ✅ | ||||
| phpcs | ✅ | ||||
| phpmd | ✅ | ||||
| psalm | ✅ | ||||
| phpstan | ✅ | ||||
| phpmetrics | ❌ | ||||
| eslint | ✅ | ||||
| stylelint | ✅ | ||||
| composer | ✅ | ✅ 100/100 | |||
| npm | ✅ | ✅ 429/429 | |||
| PHPUnit | ⏭️ | ||||
| Newman | ⏭️ | ||||
| Playwright | ⏭️ |
Quality workflow — 2026-05-13 05:50 UTC
Download the full PDF report from the workflow artifacts.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Fill all 11 journeydoc tutorial pages with real prose (8 user-track + 3 admin-track), wire the docs-capture spec end-to-end, and commit the 54 screenshots produced by a clean docs-capture run against the local dev container.
Pages filled
User track:
user/01-first-launch— open Scholiq, walk the nav, confirm OR wiringuser/02-create-course— Courses → Add Item dialog, save, open detailuser/03-enrol-students— individual + Bulk-enrol from cohort/CSVuser/04-assignments— publish brief, accept submissions, markuser/05-attendance— mark a session, roll-up to learner profileuser/06-grading— grade entries → final grade + RS256 publishuser/07-issue-certificate— verifiable credential + public verifieruser/08-track-progress— Learner profile tabsAdmin track:
admin/01-school-structure— programmes + cohorts + timetablesadmin/02-compliance-audit— signed audit-pack ZIP via Data exchangeadmin/03-admin-settings— register import, AI features, signing keyCapture spec
tests/e2e/docs-screenshots.spec.tsrewritten to drive real flows via/apps/scholiq/{courses,enrolments,...}withshoot()/dismissOverlays()/go()/captureCreateDialog()helpers cloned from the decidesk pilot (decidesk#195). Empty-state fallbacks where seed data is not yet importable (OpenRegister register-import gap openregister#1487 — only 2 of 35 Scholiq schemas import on a fresh container today, so the index lists, create dialogs and the settings page are real but detail / populated views fall back to list/empty-state).Verification
npx playwright test --project docs-capture— 11/11 pass.docs/static/screenshots/tutorials/{user,admin}/.cd docs && npm run buildends with[SUCCESS]. Only the expected/privacy///terms///iso/footer warnings.Pattern reference: decidesk#195 + ADR-030.