Title

A questionnaire has a title:

"title": "A Bunch of Questions",

Questions and Answers

Each question should have multiple answers.

Each answer must have weighting, defined as a float number between 0.0 and 1.0.

Exception: I sometimes use a value of 1.1 for "bonus answers" which allows for an overall score of more than 100%.

To calculate the overall score, the weighting of each question's answer will be used.

Example:

"questions": [
  {
    "text": "What's your favorite color?",
    "answers": [
      { "text": "blue",      "weighting": 0.7  },
      { "text": "green",     "weighting": 0.5  },
      { "text": "yellow",    "weighting": 0.1  },
      { "text": "red",       "weighting": 0.25 },
      { "text": "none",      "weighting": 1.0  },
      { "text": "checkered", "weighting": 1.1  }
    ]
  }
]

Ratings

Ratings can be defined to add a text to the result based on the achieved overall score. Each is bound to a score range.

The minimum_score value sets the threshold for each rating. The adequate rating will be chosen by finding the one with the highest minimum_score value that is lower than the score. For example, with a score of 53 % and ratings with minimum_score values of [10, 20, ..., 90, 100], the selected rating will be the one with a minimum_score value of 50 since it is lower than 53 and the next higher minimum_score value, 60, is not lower than the score of 53.

Therefore, a rating's minimum_score value defines the minimum score one has to gain to be given that rating, as long as no other rating is more suitable considering its minimum_score minimum.

Example:

"rating_levels": [
  { "minimum_score":  0, "text": "OMG, please waste time with something else!" },
  { "minimum_score": 40, "text": "Not bad." },
  { "minimum_score": 70, "text": "Looking good." },
  { "minimum_score": 90, "text": "Yeah, great result!" }
]

Rating levels are optional. If none are defined in the data file, to rating text is shown on the result page.