This page contains details for the following EPICs

https://project-sunbird.atlassian.net/browse/SB-22719 This contains Key Question Set Creation Capabilities

https://project-sunbird.atlassian.net/browse/SB-22804 Enable Course Assessment: Key Question Set Creation Capabilities (SB-22719) + Add Instruction

https://project-sunbird.atlassian.net/browse/SB-22717

https://project-sunbird.atlassian.net/browse/SB-22953 Key Question categories: MCQ, MSQ, FTB

Key Question Set Creation Capabilities

Question details form driven by primary category configuration

A tenant on Sunbird can define what details would they like to capture for each question in a question set. For instance, certain organisation might want creators to provide learning outcome & learning level for each question.

One more example, Survey allows questions to be marked as mandatory or optional. So when creating Survey, creator would get an option to mark individual question as mandatory in the Survey question set.

Each question in a question set should have a configurable details form that is driven by primary category configuration.

Metadata: To be provided by creator. Can’t be modified by person reusing it. Defined in object category definition. Overridden by question set form definition.

If an org wants LO for all questions, it should configure a question category with LO

Relational: In relation to the question set - can be set for new created or added from library. Defined in question set category definition.

→ Example of metadata configuration through question set category form definition

Show / Hide / Mandatory Solution (and Hints - in future) as per category definition

Certain categories would want to configure default as Show Solution = false, hidden in the form configuration. Question creation page should hide the Solution block accordingly. Whereas certain categories might want to make Solution mandatory.

Conclusion: Question set category will have form for Questions as well (optionally). It will override default Question category form.

Question Preview

By default show preview in 16:9 aspect ratio with landscape orientation.

Allow user to switch to portrait orientation.

Use change orientation icon for this as shown in InVision designs.

Preview Question Set

CONSUMPTION PLAYER REQUIRED

Preview button will open Question set player. Player will support Question Set preview.

Preview button is configurable - since collections might not need it.

On clicking submit, user should be able to preview the whole question set and check T&C on the confirmation page before finally submitting.

This preview will behave as if it would for a player after question set is published.

Question set capabilities to enable Course Assessment

Add Instruction for a question set

CONSUMPTION PLAYER REQUIRED

Creator should be able to add rich text (or markdown) instructions for question set (on the details page). Instructions should allow

→ basic formatting such as bold, italics, underline

→ Heading 1,2,3 styles OR Font size selection

→ Bulleted or Numbered list

→ Inserting Table

→ Adding Images

→ Adding Audio

Conclusion:

1. Add this to SBForm or build independently

2. If independent, it will be at the bottom of the Question set details page.

Question Set configuration to enable Course Assessment

CONSUMPTION PLAYER REQUIRED

Timer

→ Creator can enter maximum time in hours : minutes : seconds

On completion of maximum time, player submits the question set response and redirects user to end summary page.

→ Timer should support warning time in hours : minutes : seconds. Warning time is always less than maximum time.

→ Warning time can only be defined after maximum time is defined.

At warning time, timer text turns red and starts blinking. Timer flashes in red.

→ Show Timer is enabled automatically when user defines maximum time and cleared automatically if user removes maximum time (or makes it 00:00:00)

→ Validation: User cannot enter more than 60 seconds, 60 minutes, and 5 hours (this validation should be configurable).

→ (Optionally) If user enter 90 minutes, system could automatically convert it to 1 hour 30 minutes. Similarly if user enters 90 seconds, system could convert it to 1 minute 30 seconds, and so on.

User cannot change font, colour of timer.

Notes:

1. Use ShowTimer and TimeLimits in the Question Set object Definition

2. How does player behave if showTimer is false and timeLimit is defined by user?

Submit required

→ Creator can select Yes / No. Default value is loaded as per form configuration in category definition.

This will show a submit confirmation page in question set player. This page will also have a details of the current attempt - Questions attempted, skipped.

Max attempts

→ Creator can define max attempts for a question set. Min 1, Max 25. Default none.

Create hierarchy (Creating Sections)

CONSUMPTION PLAYER REQUIRED

Question set should allow creating hierarchy / folders (child question sets) in it.

When a folder (child question set) is created, it has its own details form as configured in the primary question set category. Creator can modify settings as per the primary category form definition.

A child question set can contain questions or question set as per the hierarchy structure definition. For now we will assume only one level of folders (question sets). So a primary question set may contain question and/or folders (question sets) at level 1, and questions at level 2 (inside child question set)

Creator can drag-and-arrange questions across sections (child question sets)

It would also be possible to restrict users from creating questions directly under primary question set. Which will ensure that all questions are under at least one child question set (section). So a structure such as the one below can be achieved.. DONE

Question Set 1                    //primary question set
  Question Set 1.1                // child question set
    Question
  Question Set 2.1
    Question

Supported: Adding Question Set to a Question Set (reuse). Adding collection to a collection.

Not supported / required: Creating Question Set within a Question Set (create). Similar to creating collection within a collection.

Question reuse

→ Allow users to filter and search relevant questions in context to the question set they are creating.

→ When user tries to ‘Add from Library’ launch the question browser with relevant context (framework categories, allowed question categories).

→ Contributor can filter using: Question categories, Medium, Class, Subject, Topic(s), My / All Questions,

In future Question reuse should also

1. Support QuML v0.5 questions as well

2. Support ECML (v2) questions as well

3. Filter out ECML (v1) questions

Question categories

Multiple choice with multiple correct answers

CONSUMPTION PLAYER REQUIRED

• Creator can mark more than one answers as correct.

  • On marking an answer as correct, its weightage is set as 1. Which means on selecting this response, the player will get full marks allotted for the question

• MCQ (or any question) with multiple correct answers will have Partial scoring = true by default. Thus,

  • All responses marked as correct will get equal marks. The total marks of the question will be divided equally amongst all responses

  • Player will get score for whichever option s/he has selected.

  • There is no negative marking.

Example,

MCQ // marks = 1
* Option 1 // score = 1
* Option 2 // score = 0
* Option 3 // score = 0
* Option 4 // score = 0

Player will get 1 marks on responding with Option 1

MCQ // marks = 1, partial scoring = true
* Option 1 // score = 1
* Option 2 // score = 0
* Option 3 // score = 1
* Option 4 // score = 0

Player will get 1/2 marks on responding with Option 1
Player will get 1/2 marks on responding with Option 3
Player will get 1 marks on responding with Option 1 & 3. (Option 2 and 4 might also be selected but they will reward any +/- marks)

Fill In The Blanks

CONSUMPTION PLAYER REQUIRED

• Creator types a few words.. a sentence maybe. Selects a word. Insert blank.

  • A blank is inserted in place of the selected word.

  • As shown in designs, creator can now specify correct responses for the inserted blank

• Creator types a few words.. typing cursor is blinking. Insert blank.

  • A blank is inserted at the cursor position.

  • Creator can specify correct responses for the inserted blank.

→ Creator can create multiple blanks in a question

→ All standard rich text editing features are available to format the text of the question

→ Correct responses for a blank

allows all characters,
any language,
does not allow LaTeX,
..

→ Blank validation is

case insensitive,
ignores more than one space,
allows all characters,
..

Question set details form driven by category configuration

DONE

Question Set details should be configurable such that it allows for flexibility yet does not burden the creator with plethora of details to be filled.

Each primary category form would define which of the behaviour configuration settings it wants to expose to the creators. For example, Practice would allow creators to modify only Shuffle, Show/hide Feedback, and Show x/y questions.

A primary category form would also define default values for the configuration settings. For example, Submit required = true for Assessment.

A primary category form would also dictate whether certain attribute is editable or viewable or hidden. For example,

• Shuffle (default false, editable) for Practice,

• Submit required (default true, viewable) for Assessment,

• Scoring mode (default = no scoring, hidden) for Survey

So, a sample primary category form would be as follows:

Practice
  Shuffle: default false, editable
  Submit required: hidden, no default (not applicable)
  Show feedback: default true, viewable
  Show solution: default true, hidden
  ...

Add / Create New Question

DONE

Adding or Creating New question should allow creating question categories as specified in the category definition. For example, Assessment will not require Subjective Reference Questions

Conclusion: Editor allows configuring a list of allowed object types & primary categories for a collection / question set category.