Sprint 2 user-testing plan
This is the planned Sprint 2 formal user-testing process. The application has already been shared informally, but no meaningful structured critique or formal user-testing results have been collected. This page is a plan, not a result or claim of participant acceptance.
Evidence status
| Evidence class | Current status |
|---|---|
| Contemporaneous evidence | No formal Sprint 2 user-test session record exists yet |
| Team-confirmed recollection | The application has been shared informally with other people, without meaningful structured critique |
| Repository evidence | Implemented player journeys, automated tests, current release validation, and known evidence gaps inform the tasks below |
| Future planned evidence | Sanitised session records, observations, participant feedback, prioritised findings, linked issues/decisions, changes, and follow-up evaluation |
Purpose
The sessions should evaluate whether a person can understand and complete the core Wits Quest loop, whether the interface communicates server-authoritative state clearly, and where usability or accessibility friction should change the product. They do not replace correctness, security, database, performance, or formal accessibility testing.
Target participants
Prefer volunteers who resemble likely users, especially Wits students or other campus users where practical. Seek varied familiarity with card games, campus navigation, mobile Web applications, and assistive or alternative input. Do not claim representativeness from convenience participants, and do not set or report a participant count until recruitment and sessions actually occur.
Author-only tasks require a separate safe Author test account and may be tested with team/client participants who understand that role. Ordinary player participants should not be given production authorisation or another person's account.
Environment and devices
- Use a named test or deployed release and record its commit or deployment identifier.
- Prefer each participant's familiar phone where safe, supplemented by a known approximately 390 px mobile viewport and a normal desktop browser when responsive comparison matters.
- Record device class, operating system/browser family, input method, viewport where known, and relevant network or campus context without collecting device identifiers.
- Use controlled test accounts and non-sensitive content. Never record passwords, tokens, browser auth state, connection strings, or private account data.
- Exercise reported-location eligibility on campus only when practical, safe, and permitted. Record a coarse scenario and result, not unnecessary precise coordinates or a location history.
- If a capability is unavailable or unsafe in the chosen environment, mark the task not run and explain why rather than simulating a pass.
Participant privacy and consent
Before a session, explain its purpose, approximate activities, voluntary nature, what will be observed, whether notes/screenshots/recording are proposed, and that the participant may stop or skip a task. Obtain explicit consent for any recording separately.
Use a non-identifying session code. Do not collect names, student numbers, emails, demographic detail, disability information, exact coordinates, or credentials unless there is a necessary approved reason. Report accessibility needs only at the level volunteered and needed to interpret the interaction. Store raw notes and any consent-controlled media outside the public repository; publish only sanitised findings.
Session process
- Record the release, environment, device context, facilitator, and anonymous session code.
- Explain that Wits Quest, not the participant, is being evaluated. Avoid teaching the interface before the task.
- Ask the participant to work naturally and optionally think aloud. The facilitator observes without leading, then records any assistance given.
- Run applicable core tasks in a consistent order, allowing safety or environment constraints to omit a task honestly.
- Ask the short feedback questions after the journey.
- Review notes immediately, remove sensitive data, separate observation from interpretation, and create candidate findings.
- Consolidate repeated findings only after preserving which sessions observed them; frequency does not replace impact.
Core player tasks
Use outcome-focused prompts rather than naming the exact control to press:
- Sign in and identify where to begin playing.
- Explain what the Explore experience appears to offer.
- Find and inspect an event using the available map and text information.
- Use the reported-location/eligibility interaction where practical and explain the result shown.
- Start and complete a challenge, including understanding time, locked answers, completion, and review.
- Inspect the reward result and find the relevant collection state.
- Create or update a valid deck and select it for play.
- Start and complete a CPU battle, then find the stored result or history.
- Use player profile/account, password-reset, and account-deletion entry points once those capabilities are actually available and safe to test.
Do not treat unavailable account/profile work as a failed participant task. It must remain explicitly not run until the capability exists.
Observations to record
For each task, record:
- completed, completed with assistance, not completed, not run, or blocked by a product/environment defect;
- the participant's first action and navigation path;
- hesitation, backtracking, repeated actions, misunderstandings, and requests for help;
- assistance given and the point at which it became necessary;
- error, loading, permission, timeout, empty, completed, and recovery states encountered;
- whether authoritative eligibility, score, reward, deck, and battle status was understood;
- whether map-independent information was found and usable;
- observable keyboard, focus, touch, zoom, text, contrast, motion, or screen-reader friction relevant to the participant; and
- concise participant wording only when captured accurately and consented. Do not reconstruct quotations from memory.
Task duration may be recorded as supporting context, but it is not a score and must not be compared across materially different environments without noting the difference.
Usability and accessibility questions
The facilitator should evaluate:
- Can the participant tell what to do next without coaching?
- Is the difference between discovery, eligibility, challenge availability, and completion understandable?
- Are map and text representations consistent, and can the task continue when the map is unavailable?
- Are loading, failure, permission, retry, empty, disabled, and completed states clear and recoverable?
- Are controls labelled, reachable, and usable with the participant's input method?
- Does focus move predictably and remain visible where keyboard interaction is used?
- Are touch targets, text, wrapping, zoom, contrast, and motion comfortable in the observed context?
- Does game terminology explain enough without overwhelming the journey?
- Does the interface avoid implying that a reported location proves presence?
Short participant feedback
Ask the same concise questions where possible:
- What did you think Wits Quest wanted you to do?
- Which part felt easiest, and why?
- Where did you feel uncertain, stuck, or surprised?
- Did any status, rule, or game term feel unclear?
- Was anything difficult to see, reach, read, or operate?
- What is the single most important change you would make?
- Would you use this on campus, and what would affect that decision?
These answers are feedback, not formal acceptance or statistically representative survey results.
Finding severity and priority
Classify the observed impact before scheduling work:
| Severity | Meaning |
|---|---|
| Critical | Prevents a core journey for affected users, risks security/privacy/data integrity, or creates a severe accessibility barrier with no practical workaround |
| High | Causes task failure or requires facilitator help on an important journey, with only a difficult workaround |
| Medium | Creates repeated confusion, delay, or error but the task can be completed independently |
| Low | Minor clarity, consistency, or polish issue with limited task impact |
Priority also considers recurrence across sessions, affected journey, safety, accessibility, implementation risk, dependencies, and milestone timing. One critical observation can outrank a frequently mentioned preference. Preferences that conflict with protected authority, privacy, confirmed rules, or scope are evaluated and documented rather than implemented automatically.
Traceability into work
Give each sanitised finding a stable identifier such as UT-S2-01. Record its
source session code(s), observed behaviour, expected behaviour, evidence class,
severity, team evaluation, and decision.
- A change accepted for implementation becomes or links to a Gitea issue with acceptance criteria and the finding identifier.
- A rejected or deferred suggestion records the product, security, accessibility, technical, dependency, or scope reason without blaming the participant.
- The pull request and relevant test/documentation refer back to the issue and finding.
- Follow-up testing records whether the same task improved, remained, or regressed. It does not overwrite the original observation.
Publish a sanitised results summary only after sessions occur. Separate what participants did, what they said, the team's interpretation, the decision, and the resulting change.
AI declaration
This planned Sprint 2 user-testing process was generated, edited, and reviewed with the assistance of Codex[GPT-5]. It contains no fabricated participants, sessions, observations, quotations, or results.