getodk / getodk/web-forms

Guidance hints

Open
#53 3 comments 0 reactions 0 assignees View on GitHub
enhancement front-end In Collect In Enketo needs ui/ux design
Dominant language
TypeScript
Stars
38
Forks
22
PR merge metrics
No merged PRs in 30d

Description

Add support for the `guidance` form for labels. This is used to provide additional guidance about a question that isn't always needed and so is collapsed by default.

Make sure `` are supported inside the `guidance`.

User docs: https://docs.getodk.org/form-language/, https://docs.getodk.org/collect-settings/#show-guidance-for-questions
Spec: bottom of https://getodk.github.io/xforms-spec/#languages

[XLSForm](https://docs.google.com/spreadsheets/d/1BTp0NxraUTBnK74Ucj4XW9AZmTUFPMz6I3uVZPxQzNI/edit?gid=720789817#gid=720789817)

Collect

Image

Image

Enketo

Image

Image

Contributor guide

No contributing guide indexed for this repository

Research direction

Start by reading the XForms language specification and the linked ODK form-language and Collect settings documentation, then trace existing label handling in web-forms. Add the guidance form with collapsed-by-default behavior and support inside it; done means matching the documented Collect and Enketo behavior.

Written by the indexing model from the issue text.

Assessment

Tech stack
typescript
Domain
frontend, web-dev
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.