User Tools

Site Tools


wiki:help

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

wiki:help [2013/09/08 18:15] (current)
tom created
Line 1: Line 1:
 +====== Welcome to Quizable.org ======
 +
 +[[http://​quizable.org|Return to Quizable.org]]
 +
 +Quizable was written to be a quick and easy way for busy teachers to put online, deadlined, and graded questions in front of their students. ​
 +
 +Issuing questions using Quizable was designed to be similar to sending an email: type some text (your question) and click "​send." ​ We find the "​usual"​ online question systems (Blackboard,​ Moodle, etc.) to require //too many clicks// in order to pose a question.
 +
 +For each class you wish to use Quizable for, there are a few set-up steps required.
 +
 +===== Make an account =====
 +
 +To begin, go to [[http://​quizable.org|Quizable.org]] and either log in or create an account for yourself.
 +
 +===== Create a class =====
 +
 +Once logged in, you'll see two tabs, one for teachers and one for students. ​ Under the teacher tab, you should see this:
 +
 +{{:​wiki:​create_a_class.png|}}
 +
 +Click the "​Create a new class" link to create a class for yourself. ​ This screen should come up. 
 +
 +{{:​wiki:​create_a_class_form.png|}}
 +
 +For the "Class title,"​ fill in a course description that will always be familiar to your students, so they'​ll always know they are the right place.
 +
 +Under "Class code," fill in some shortish code your students will use to initially join your class. You will tell them this code in class or on your syllabus, etc.
 +
 +Next, you'll return to the list of your classes as shown here. Create as many classes as you need. For now, we'll work with just the one "​Astronomy 101" course.
 +
 +===== See a list of your classes =====
 +
 +{{:​wiki:​class_listing.png|}}
 +
 +You can see the course code is clickable, followed by your description of the course. ​ A "grade report"​ link is available for tallying all students points as per your needs. ​ Clicking on the course-code link will bring up a list of questions current written for this course. Initially there are no questions, as shown here
 +
 +{{:​wiki:​make_question.png|}}
 +
 +
 +but a "Write a question"​ link is available. ​
 +
 +When this link is clicked a question creation form will be shown.
 +
 +===== Write a question =====
 +
 +As per our design, there aren't many things to click on when writing a question.
 +
 +{{:​wiki:​create_question.png|}}
 +
 +  * If you upload an attachment, it will be made available to your students. Images (jpg, png, bmp, etc.) will be shown as an illustration to your question. Other fils such as PDFs or doc file will be available as a clickable link.  ​
 +
 +  * Set a deadline for when students need to answer this question, by clicking into the "​Date"​ and "​Time"​ boxes.
 +
 +Now, let's write a question. ​ With only a few clicks and a bit of typing, you'll have your question up and ready to go.  Again, posing a question here is a lot like typing an email: you do a bit of typing then click "​go."​
 +
 +==== Multiple Choice Questions ====
 +
 +Multiple choice questions are coded with this pattern:
 +
 +<​code>​
 +mc//​question-text//​choice1//​choice2//​..//​choiceN//#​end//​points-worth//​allowed-attempts//​deductions-per-attempt//​answer-on-expire(yes/​no) ​
 +</​code>​
 +
 +This means to create a multiple choice question, type the following into "The Question"​ box.
 +
 +  - mc (this is the code for **m**ultiple **c**hoice).
 +  - Two forward slashes like this: %%//%%
 +  - The text of your question
 +  - %%//%%
 +  - The first answer choice
 +  - %%//%%
 +  - The second answer choice
 +  - %%//%%
 +  - As many more answer choices as you require, each separated by a %%//%%
 +  - The exact word %%#end%% (to signify the end of your answer choices)
 +  - %%//%%
 +  - The number of points the correct answer is worth
 +  - %%//%%
 +  - The number of attempts a student can have to answer the question.
 +  - %%//%%
 +  - The point deduction per attempt.
 +  - %%//%%
 +  - A ''​yes''​ or ''​no''​ on whether or not the correct answer should be shown when the question expires.
 +
 +That's it to composing a multiple choice question. Here is a sample question:
 +
 +{{:​wiki:​mc_preview.png|}}
 +
 +that was created from this text
 +
 +<​code>​
 +mc//Which is closest to the Sun?//​Earth//​Venus//​*Mercury//​Saturn//#​end//​3//​4//​.1//​yes
 +</​code> ​
 +
 +as shown here
 +
 +{{:​wiki:​mc_question.png|}}
 +
 +==== Testing your questions ===
 +
 +To test your questions, simply return to your main menu (see upper right of your screen), and "​pretend"​ you're a student. Join your own class (you'​ll need your course code), and test away!
 +
 +==== Numerical Questions ====
 +
 +Numerical questions are questions that students answer by suppling a single number (as in, the answer to some problem). ​ Numerical questions are coded in this way:
 +
 +<code css>
 +num//​question-text//​correct-answer//​units//​allowable-margin-%//​absolute-value-(yes/​no)//​points-worth//​allowed-attempts//​deductions-per-attempt//​answer-on-expire-(yes/​no) ​
 +</​code>​
 +
 +In other words, to compose a numerical question, type
 +
 +  - num (the code for a **num**erical question).
 +  - %%//%%
 +  - The text of your question.
 +  - %%//%%
 +  - The correct numerical answer.
 +  - %%//%%
 +  - The physical units student should use when forming their answer (e.g. feet, Joules, etc.)
 +  - %%//%%
 +  - The margin of numerical error you are willing to allow for incoming numbers (type a number between 0 and 100, which will be interpreted by Quizable as a percent).
 +  - %%//%%
 +  - A ''​yes''​ or ''​no''​ on whether or not Quizable should immediately take the absolute value of incoming answers.
 +  - %%//%%
 +  - The number of points the correct answer is worth
 +  - %%//%%
 +  - The number of attempts a student can have to answer the question.
 +  - %%//%%
 +  - The point deduction per attempt.
 +  - %%//%%
 +  - A ''​yes''​ or ''​no''​ on whether or not the correct answer should be shown when the question expires.
 +
 +As an example, to create a question that looks like this (with a 5% margin of error and not taking the absolute value of incoming answers)
 +
 +{{:​wiki:​num_question.png|}}
 +
 +you would type the following text into "The Question"​ box:
 +
 +{{:​wiki:​num_question_text.png|}}
 +
 +==== Short Answer ====
 +
 +A short answer question is one where the student is required to type a few lines of text for an answer. These are not graded automatically by the computer. They are coded in this way:
 +
 +{{:​wiki:​sa_question_text.png|}}
 +
 +to produce a question like this:
 +
 +{{:​wiki:​sa_question.png|}}
 +
 +To code a short answer question,
 +
 +  - Start with sa (for short answer).
 +  - %%//%%
 +  - Type the text of the question.
 +  - %%//%%
 +  - How many points the question is worth.
 +
 +Note that students are only granted one attempt to answer such questions.
 +
 +=== Grading Answers to Short Answer Questions ===
 +You (the teacher) has to do grade these answers manually. You'll know such answers need grading when next to the question in your class menu, you'll see the following (see the red oval).
 +
 +{{:​wiki:​sa_to_grade.png|}}
 +
 +Clicking on the link in the red oval will bring you to a grading page, where you can score and comment on the students'​ answers.
 +
 +==== Draw-it question ====
 +
 +A "​draw-it"​ question is one where the student is required to //draw something// for an answer. These are not graded automatically by the computer. They are coded in this way:
 +
 +{{:​wiki:​dr_question_text.png|}}
 +
 +to produce a question like this:
 +
 +{{:​wiki:​dr_input.png|}}
 +
 +where a "​mini-paint"​ program is brought up, to be used for drawing an answer.
 +
 +To code a draw-it question,
 +
 +  - Start with dr (for **dr**awing).
 +  - %%//%%
 +  - Type the text of what should be drawn.
 +  - %%//%%
 +  - If you upload an attachment //image// with the question, supply a ''​yes''​ or ''​no''​ here as to if the image should be placed as the background to the drawing canvas. This allows students to draw or annotate an answer over some "​starting"​ image you supply.
 +  - %%//%%
 +  - How many points the question is worth.
 +
 +Note that students are only granted one attempt to answer such questions.
 +
 +=== Grading Answers to Draw-it Questions ===
 +
 +Like short answer questions, you (the teacher) must grade draw-it answers manually. You'll know such answers need grading when next to the draw-it question in your class menu, you'll see a notification that there are ungraded drawings. Also like short answer questions, you can grade and optionally comment on the incoming drawings.
  
wiki/help.txt ยท Last modified: 2013/09/08 18:15 by tom