Complete the Training
Whether it is a video, a document, an instructor-led course or some other format, fully satisfying the course expectations and absorbing all of the material is the first step towards creating great content based upon it.
| Tip | ||
|---|---|---|
| ||
Take notes early and often. The more material you have to work with once the training is complete, the easier it will be to create a list of questions in both great quality and great quantity. |
Get the Template
See https://bitbucket.org/solutechnology/onb-question-repository/raw/HEAD/Supporting%20Content/question_template.txt for the latest quiz creation template and visit Training Process: Initial Setup to retrieve the file directly from Git.
Understand the Template Fields
General Fields
Category
This is the category of the question. If you do not see the category you want on the list provided on the template please request it to be added. The categories below and their number are correct, even though the template may not include them in the listed categories, simply putting the number in will work for the unlisted categories. This list will be kept up to date as categories are added.
Current Category List
0 Generic
1 Java
2 Axure
3 JIRA
4 OOPObject Oriented Programing
5 SDLCSoftware Development Life Cycle
6 Communication
7 Unix Scripting
8 HTML
9 CSS
10 JavaScript
11 Angular JS
12 Design Patterns
13 Git
14 Java Design Pattern
15 Business Analysis
16 Version Control
17 Presentations
Grade Style
Only applicable for 'multiplechoice' (with more then 1 correct answer) style questions
0: Give full score only when all correct responses are provided
1: Give partial score per correct response and deduct partial score for incorrect responses
2: Give partial score per correct response but do not deduct partial score for incorrect responses
Random Answers
A Boolean for if the answers' order is randomized. 0 means no randomization and a 1 means to randomize the answers.
Submitter
This is the name of the person creating and submitting the questions.
Course Site
This is the site the course was taken on. The options for this are Lynda, and Udemy.
Course Name
This is the exact name of the course as it is written on the site.
Course URL
The URL of the course.
Discipline
This is what discipline the training is classified under, Professional or Technical.
Question Fields
Type
Description
What form should the answer(s) take?
Multiple Choice
A single answer chosen from a list of possible answers
Multiple Select (This is a form of multiple choice in the template)
Two or more correct answers chosen from a list of possible answers
True or False
A statement of an unknown truth value which the answer is chosen from true or false.
Valid Values
multiplechoice, truefalse
Question
Description
What do you want to ask?
Example Value
What qualities should an awesome question have? (Select all that apply.)
(A)-(E)
Description
Provide possible answers to the question. These are lettered A-E for reference by the (Correct) field.
Correct
Description
Provide the correct answer(s) to the question.
| Note |
|---|
| For multiple select questions create a multiple choice question and then select multiple answers for correct using the syntax of (Correct): A,B |
Points
Description
The weight of the question, defaults to 1.
Example Value
Any real number
CF/WF
Description
Correct Feedback and Wrong Feed back respectively. These are shown the the quiz taker upon answering a question right or wrong. An explanation of the answer is a useful thing to add to this section.
Example Value
An awesome question should have all of the qualities necessary to properly test a candidate's knowledge. It should NOT focus too narrowly on terminology or opinions specific to training source material.
Hint
Description
This is an optional field that can be used if you wish to provide a hint to the user about the question.
Example Value
This can be used to help people know the answer.
Subject
Description
This is similar to category but can be used to specify more specific detail on the category.
Example Value
Question subject
Difficulty
Description
This is a range of difficulty of the question, Beginner, Intermediate, and Advanced.
Valid Values
Beginner, Intermediate, Advanced
Applicability
Description
This is if the question is about the course or can be applied to the category in general.
Valid Values
General, Course
Example Question
The following illustrates an example question created with the template and defined utilizing the fields and examples described above.
(STARTIGNORE)
Quiz Details
(Submitter): Jason Crocker
(Course Site): TBD
(Course Name): Question Creation and You
(Course URL): www.tbd.com
(Discipline): professional
(ENDIGNORE)
(STARTIGNORE)
(Hint): What is the site you are currently on called?
(Subject): Question Creation
(Difficulty): Beginner
(Applicability): General
(ENDIGNORE)
Follow Best Practices
A good question should be aligned with each of the following best practices.
| Tip | ||
|---|---|---|
| ||
|