Page Comparison

...

Code Block

language	json

"mappingDef": {
            "type": "arrayobject",
    "items": {       "typerequired": "object"["key", "value"],
            "properties": {
        "key": {           "key": {"$ref": "#/definitions/anyTypeDef"},
        },         "value": {
          "type": "number"},
        },         "caseSensitive": {
          "type": "boolean",           "default": false}
        }    },
  }     },     "propertiesadditionalProperties": {false
        "key}

Proposed QuML spec (v1.1):

Code Block

language	json

"mappingDef": {
            "$reftype": "#/definitions/anyTypeDef"
array",
     },       "valueitems": {
                "type": "numberobject",
      },          "caseSensitiverequired": {
["value", "score"],
       "type": "boolean",         "defaultproperties": false{
      }     },     "additionalProperties": false   }

Proposed QuML spec (v1.1):

Code Block

language	json

"mappingDef"value": {"$ref": "#/definitions/anyTypeDef"},
           "type": "array",             "items"score": {
                "type": "objectnumber"},
                    "requiredcaseSensitive": [{"valuetype",: "scoreboolean"], "default": false}
              "properties": {    },
                "valueadditionalProperties": {"$ref": "#/definitions/anyTypeDef"},false
            }
        "score": {"type": "number"},}

Sample Data for QuML (v1.1):

Code Block

language	json

"mapping": [
        {
           "caseSensitivevalue": {"type": "boolean", "default": false}2,
          "score": 0.5
        },
        {
          "additionalPropertiesvalue": false1,
          "score": 0.25
}         }}
      ]

...

~~Attribute Name:~~ ~~interactions~~

...

Code Block

language	json

"solutions": {
      "description": "Solutions to the question.",
      "oneOf": [
        {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "List of solutions without association to any specific language",
          "minItems": 1
        },
        {
          "type": "array",
          "items": { "$ref": "#/definitions/i18nData" },
          "description": "Solutions in different languages for multi-lingual questions.",
          "minItems": 1
        }
      ]
    }

Proposed QuML spec (v1.1Sample Data for Quml Spec (1.0):

Code Block

language	json

Attribute Name: bloomsLevel

Data type mismatch found between spec json and wiki page.
https://github.com/sunbird-specs/QuML/blob/master/v1/question-schema.json
Question Definition

Current QuML spec (v1):

Code Block

language	json

"bloomsLevel": // for single language
{
  "solutions": [
    "solution 1 having html string",
    "solution 2 having html string",
    "solution 3 having html string"
  ]
}

//for multi language
{
  "solutions": [
    {
      "en": "solution 1 having html string"
    },
    {
      "hi": "solution 2 having html string"
    }
  ]
}

Proposed QuML spec (v1.1):

Code Block

language	json

"solutions": {
      "description": "Solutions to the question.",
      "type": "object",
      "additionalProperties": {
        "oneOf": [
          {
            "type": "string"
          },
          { "$ref": "#/definitions/i18nData" }
        ]
      }
    }

Sample Data for QuML Spec (v1.1):

Code Block

// for single language

{
  "solutions": {
    "solution_1": "<div>...</div>",
    "solution_2": "<div>...</div>"
  }
}

//for multi language 
{
  "solutions": {
    "solution_1": {
      "en": "<div>...</div>",
      "hi": "<div>...</div>"
    },
    "solution_2": {
      "en": "<div>...</div>",
      "hi": "<div>...</div>"
    }
  }
}

solution_1 & solution_2 are unique identifiers for different solution

...

Attribute Name: bloomsLevel

Data type mismatch found between spec json and wiki page.
https://github.com/sunbird-specs/QuML/blob/master/v1/question-schema.json
Question Definition

Current QuML spec (v1):

Code Block

language	json

"bloomsLevel": {
      "type": "array",
      "enum": [""],
      "description": "Cognitive processes involved to answer the question."
    }

Proposed QuML spec (v1.1):

Code Block

language	json

"complexityLevel": {
    "type": "array",
    "items": {
      "type": "string",
    },
    "description": "Cognitive processes involved to answer the question."
  }

...

Attribute Name: feedback
Current QuML spec (v1):

Code Block

language	json

"feedback": {
      "description": "Feedback shown to the students after response processing.",
      "type": "array",
      "items": {
        "type": "object",
        "required": [ "id", "body" ],
        "properties": {
          "id": {
            "description": "Identifier of the feedback object.",
            "type": "string"
          },
          "body": {
            "description": "Body of the feedback to be rendered for the specified feedback identifier.",
            "oneOf": [
              {
                "type": "string",
                "description": "Feedback as HTML string when the question is used in only one language."
              },
              { "$ref": "#/definitions/i18nData" }
            ]
          }
        }
      }
    }

Sample Data for QuML (v1.0):

Code Block

// single language
{
  "feedback": [
      {
        "id": "feedback_1",
        "body": "<div>...</div>"
      },
      {
        "id": "feedback_2",
        "body": "<div>...</div>"
      }
    ]
}

// multi language:

{
	"feedback": [
    {
      "id": "feedback_1",
      "body": {
        "en": "<div>...</div>",
        "hi": "<div>...</div>",
        "ka": "<div>...</div>"
      }
    },
    {
      "id": "feedback_2",
      "body": {
        "en": "<div>...</div>",
        "ka": "<div>...</div>"
      }
    }
  ]
}

Proposed QuML spec (v1.1):

Code Block

language	json

"feedback": {
      "description": "Feedback shown to the students after response processing.",
      "type": "object",
      "additionalProperties": {
        "oneOf": [
          {
            "type": "string"
          },
          { "$ref": "#/definitions/i18nData" }
        ]
      }
    }

Sample Data for QuML (v1.1):

Code Block

//single language:
{
  "feedback": {
    "feedback_1": "<div>...</div>",
    "feedback_2": "<div>...</div>"
  }
}


//multi language:
{
  "feedback": {
    "feedback_1": {
      "en": "<div>...</div>",
      "hi": "<div>...</div>"
    },
    "feedback_2": {
      "en": "<div>...</div>",
      "hi": "<div>...</div>"
    }
  }
}

...

Attribute Name: hints
Current QuML spec (v1):

Code Block

language	json

"hints": {
      "description": "Hints are shown to the students after response processing or when the student requests for hints.",
      "type": "array",
      "items": {
        "type": "object",
        "required": [ "id", "body" ],
        "properties": {
          "id": {
            "description": "Identifier of the hint object.",
            "type": "string"
          },
          "body": {
            "description": "Body of the hint to be rendered for the specified hint identifier.",
            "oneOf": [
              {
                "type": "string",
                "description": "Hint as HTML string when the question is used in only one language."
              },
              { "$ref": "#/definitions/i18nData" }
            ]
          }
        }
      }
    }

Sample Data for QuML (v1.0):

Code Block
{ "hints": [ { "id": "hint_1", "body": "<div>...</div>" }, { "id": "hint_2", "body": { "en": "<div>...</div>", "hi": "<div>...</div>", "ka": "<div>...</div>" } } ] }

Proposed QuML spec (v1.1):

Code Block

language	json

"hints": {
      "description": "Hints of the question.",
      "type": "object",
      "additionalProperties": {
        "oneOf": [
          {
            "type": "array",string"
          },
          { "enum$ref": [""],#/definitions/i18nData" }
        "description": "Cognitive processes involved to answer the question."]
      }
    }

Proposed Sample Data for QuML spec (v1.1):

Code Block

language	json

"complexityLevel{
  "hints": {

    "typehint_1": "array<div>...</div>",

    "itemshint_2": {
      "typeen": "string<div>...</div>",
    },   "hi":  "description": "Cognitive processes involved to answer the question."
 "<div>...</div>"
    }
  }
}

...

Spec Changes for QuestionSet:

There are some special characters in line number 27 & 51. So need to re-write these lines.
coordinateDef is not available but coordinate definition is available which is being referred from line number 215. So need correction at line number 215.
media definition is missing which is being referred from anyTypeDef (line number: 224). So need to add media definition.

Conclusion (DC Review):
17-APR-2023:

answer property will be mandatory at spec level. All question types (interactive & non interactive) should have answer field.
inquiry editor should make changes to populate answer field (either auto generate or take it from user ) for all question types
.

Versions Compared

Old Version 13

New Version Current

Key