RegenCHOICE → [[ch:qs:|question structuring]]

====== Level scale question structure ======

This is used for the level or grade of something
  * use where assumption can be that higher level is better
  * needs a single dimension (e.g. competence)
  * needs a defined set of levels, or to use a predefined level scheme
  * a higher level is taken to include all lower levels

Structurally this is almost the same as the options list [[OPTSQ]], but with the added feature that there is an inherent ordering of the items in terms of value, priority or preferability.

There may be an externally-defined scheme for the answer items, used in other contexts, and this may or may not have a set numeric correlate.((Examples that come to mind include language test scores; chess categories with ELO ratings; GPAs)) If the numbers go along with more is better, then we can use the given numbers as they are. If they are reversed (as in the old-fashioned academic degree classification) then they will need to be redefined, as for RegenCHOICE we will define a greater number as better. If there isn't a given numeric correlate then we need to supply one.

As with [[OPTSQ]], the items need a short form for display and a long form for explanation and clarity.

===== Data structure =====
Common attributes as in Question information structure, plus [[ch:fields:QDetails]] as follows:

IF [[ch:fields:QSchB]] (Boolean, mandatory) is true, that is, an external level scheme is defined

THEN:
  * [[ch:fields:QScheme]] predefined level scheme, URI\\  (this needs to adopt a particular standard format, to be detailed)

ELSE:
  * for each (of [[ch:fields:Qni]], given) level item:
    * [[ch:fields:QItemShort]]: @lang: short item text, for display
    * [[ch:fields:QItemLong]]: @lang: long item text
    * [[ch:fields:QItemVal]]: numeric value for Item
      * greater = higher level, higher value, which includes lower levels

===== Similar structures =====
  * Use [[OPTSQ]] if the options have no ordering.

===== Commentary =====
I keep on quoting, as a good, effective, and well-used example, the
[[wp>Common European Framework of Reference for Languages]]

----

=== see also ===
  * Template for [[ch:cr:LEVLQ]] criteria
  * For some spec details, see [[https://www.simongrant.org/RegenCHOICE/question-struct/LEVLQ.html|the HTML site]]

=== backlinks ===
{{backlinks>.}}