Inline Contextual Help Without Leaving the Screen
Peer mentors with lower digital literacy or cognitive challenges frequently get stuck on ambiguous form fields or unfamiliar terminology. The inline contextual help widget must display a brief, jargon-free explanation in a tooltip or expandable panel triggered by a clearly marked help icon (question mark) adjacent to each field that benefits from clarification. Help content is sourced from the centralised help content registry to ensure consistency and easy editing by administrators. Organisation-specific terminology (via the organisation labels system) must be reflected in help text.
User Story
Acceptance Criteria
- Given I am filling out a form field I do not understand, When I tap the help icon next to that field, Then a short explanation (max 2 sentences) appears inline without navigating away from the screen
- Given the help panel is open, When I read the explanation, Then it uses plain language and avoids abbreviations or technical terms
- Given the organisation has custom terminology configured, When the help text for a field is displayed, Then it uses the organisation-specific label (e.g., 'frivillig' instead of 'likeperson' if configured)
- Given the help content registry is populated, When a coordinator or admin updates help text, Then the change is reflected in the app on next launch without a code deployment
- Given the help panel is open and I am using a screen reader, When focus moves to the help text, Then the full explanation is announced and the panel is properly labelled as a help tooltip
- Given I close the help panel, When I continue filling out the form, Then focus returns to the field I was editing
Business Value
Reducing the need for peer mentors to contact coordinators for basic guidance lowers administrative overhead and builds user confidence. All three workshop organisations emphasised the importance of self-service guidance for users with limited digital experience. This feature enables the app to serve as a standalone tool rather than requiring coordinator accompaniment during first use.