Design Spec for Editor:  Challenge Question authoring template

OVERVIEW

This visual design document shows the template for editing a Challenge Question.

VERSION HISTORY

Based off of the most recent launch of the authoring shell and Matt's Design Docs on Challenge Question. 

Current Setup:
*Choice Interactions Label:    
Radio Button 1      Choice1EditableTextBox        RemoveStepIcon     AddStepIcon
Radio Button 2      Choice1EditableTextBox        RemoveStepIcon     AddStepIcon
Radio Button 3      Choice1EditableTextBox        RemoveStepIcon     AddStepIcon
Radio Button 4      Choice1EditableTextBox        RemoveStepIcon     AddStepIcon
etc.

Requirements:

• Choices: Min = 2, Max = 6 (potentially extended to more later).
• - if # choices = 2 disable the "Remove Choice" button                                                                                                                                                                                                                      - if # choices = 6 disable the "Add Choice" button * Feedbacks: Always 4 feedbacks (no matter how many answer choices there are)
• seems okay to hardcode using a variable to set to 4

• Evidence Step chooser : # allows the author to select from any of the previous steps (if any) for that particular activity, not all the previous steps for the entire project.

1. maybe accessing the pasProjectTree and getting its children (the nodes representing the activities and steps), would help with this
2. create a drop-down menu and insert all the nodes from the current activity which are the previous steps
3. insert these previous steps into the drop-down menu.* Attempts: same as number of feedbacks, which is 4 

• Scoring System: What type of data will be stored?

            - Option 1: create an integer array for the scores. In this case:

                - Storage: perhaps one converts the image stars for the qualitative version into numbers (1-4) for storage while the stars are displayed on                 screen.
                - Retrieval: check if qualitative or quantitative -> if qualitative, convert the scores to images for viewing purposes.

       - when reloading data:
            if(qualitative)
                    map each score to the respective star...e.g.
                    1 -> gold, 2 -> silver, 3 -> bronze, 4 -> whatever Matt chooses for that and display the corresponding star in each score box  
            else
                    retrieve the saved numerical scores and show them

* If the Off option is chosen, the score array is null (no scores exist). The easiest option to handle.

• Answer Layout: No random ordering vs. random ordering

       - Possible Solution: have boolean class field to hold this value, use a setter to set this value and a getter to return this value to the challenge question. This way, challenge question can check this to     determine whether to scramble the answers or not. Does this sound right?

• Factual Followups: Should be the same number as the choices, and I guess each factual followup maps to the corresponding choice? For example, the first factual followup corresponds to the first choice the author has made, etc.

• Assuming that the save function works, how does retrieving the data work? I mean, given that the pas-author-runtime project is using many files from Pas-Learner-Runtime (and therefore depends on it),  how does each step created in the authoring tool map to the corresponding code in the Pas-Learner-Runtime? For example, if a Challenge Question step is created and all these options are made as per Matt's specs, is the saved information read from the file where the actual logic occurs (in this case, ChallengeQuestionUI.java)? I am just guessing here, I don't know how this works.