Skip to content

docs: Likert scale and duration question types#33

Merged
IamLRBA merged 5 commits into
mainfrom
docs/likert-and-duration-question-types
Jul 2, 2026
Merged

docs: Likert scale and duration question types#33
IamLRBA merged 5 commits into
mainfrom
docs/likert-and-duration-question-types

Conversation

@najuna-brian

@najuna-brian najuna-brian commented Jul 2, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Document the new format: "likert" and format: "duration" question types in the form specifications reference
  • Add quick-start JSON examples, preset reference, copy-paste recipes, and "what gets stored" tables for form authors
  • Clarify that Likert display variants are generic (not topic-specific), with guidance for N/A validation, equal-width tablet layout, and translating option labels via ui.json options.oneOf

Companion to OpenDataEnsemble/ode#693 (Formplayer implementation).

Test plan

  • Preview the docs site locally and confirm the new sections render correctly under Form specifications → Likert scale and Duration / Timer
  • Verify JSON examples and admonitions (tip/note) display as expected
  • Spot-check links (e.g. form translations guide) resolve correctly

Add form-author reference for the built-in `likert` and `duration`
question types under Reference → Form Specifications → Question Types,
covering display modes, colour, presets, layout, N/A, and stored values.
Expand form-specifications with end-to-end schema/ui.json examples,
stored-value tables, preset reference, copy-paste recipes for common
variants, and duration mode examples so new form authors can use them
directly.
Note that any display works with any oneOf labels, rename the pain-slider
recipe to a generic 0-10 slider pattern, and add a task-difficulty example.
Document automatic Not applicable schema handling, equal-width grid layout on tablets, and translating scale option labels via ui.json options.oneOf.
@najuna-brian najuna-brian requested a review from IamLRBA July 2, 2026 16:17
@IamLRBA IamLRBA merged commit 25ebd0a into main Jul 2, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants