What is the general goal of the feature?
Sometimes survey organizers want to share more information about the meaning or intent of a particular question. Hints can be used for this but they will always be displayed. A new hint form called "guidance" was recently introduced to the ODK XForms spec to represent a longer training narrative that isn't always wanted in the user interface. See https://opendatakit.github.io/xforms-spec/#languages.
What are some example use cases for this feature?
- During training, provide additional guidance about certain questions that is then hidden for data collection.
- For long-running forms that don't need to be filled out very frequently, enumerators can optionally view extra details about a question to jog their memory on what they should say to their subjects.
In Collect, I propose adding a setting at the bottom of
General settings > form management > form filling labeled
Show guidance for questions. Possible options are:
No- this is the default. Any guidance text in the form is ignored.
Yes- the guidance text is shown below the hint text in blue italics so that it stands out.
Yes - collapsed- the guidance text is shown collapsed by default with the option to click to expand (e.g. https://github.com/freecats/TextViewExpandableAnimation).