Skip to content
This repository has been archived by the owner on Nov 2, 2023. It is now read-only.

Add guidance to questions #238

Closed
florianm opened this issue Dec 1, 2020 · 1 comment
Closed

Add guidance to questions #238

florianm opened this issue Dec 1, 2020 · 1 comment

Comments

@florianm
Copy link
Contributor

florianm commented Dec 1, 2020

Would it be feasible to add "guidance" to fields?

Most help text I'm showing as hints would be far better off as "guidance" with the option to collapse and thus make the form more compact for experienced enumerators, while allowing to include sufficient help text to enumerators in training.

Found in XForms spec:

<text id="how-old-label">
    <value>How old are you?</value>
    <value form="short">Age</value>
</text>
<text id="how-old-hint">
    <value>Enter a number</value>
    <value form="guidance">If the age is less than 18, the remainder of the survey will be hidden.</value>
</text>

Possible implementation:
ODK Build could offer a field "guidance" after the field "hint" input which adds the guidance as <value form="guidance"...</value> to the respective <text id="...:hint"> nodes.
And while we're there, support for a short label might be very similar to add.

A hack for now:

  • Append the guidance text to the text in hint, separated by a string like GUIDANCE.
  • Export to XML.
  • Edit XML, search-replace all occurrences of GUIDANCE with </value><value form="guidance">.
  • Publish form e.g. through ODK Central.
@florianm florianm changed the title Add guidance Add option to toggle form guidance for hints Dec 1, 2020
@florianm florianm changed the title Add option to toggle form guidance for hints Add guidance to questions Dec 2, 2020
@florianm
Copy link
Contributor Author

florianm commented Dec 8, 2020

Closing as duplicate of #242

@florianm florianm closed this as completed Dec 8, 2020
@florianm florianm added this to the 0.4.0 milestone Dec 8, 2021
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Projects
None yet
Development

No branches or pull requests

2 participants