summaryrefslogtreecommitdiff
path: root/yaksh/documentation/moderator_docs/creating_question.rst
blob: 0de5e43a0c3343dfc5bab392851753551f7d6e86 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
=========
Questions
=========

Setting up questions
--------------------

	Setting up questions is the most important part of the Yaksh experience. Questions can be of multiple types i.e Multiple choice questions (MCQ), Multiple correct choices (MCC), Coding questions and assignment upload types.

	To set up a question click on the questions link in the navigation bar.

	.. image:: ../images/questions.jpg 
	
	To add a question click on the **Add Question** button

	.. image:: ../images/add_question.jpg

	* **Summary**- Summary or the name of the question.

	* **Language** - Programming language on which the question is based.

	* **Type** - Type of the question. i.e Multiple Choice, Multiple Correct Choice, Code and Assignment Upload.

	* **Points** - Points is the marks for a question.

	* **Description** - The actual question description is to be written. 

		.. note::  To add codes in questions please use html <code> and <br> tags.

	* **Tags** - Type of label or metadata tag making it easier to find specific type of questions.

	* **Snippet** - Snippet is used to give any default value or default code or command. This will be displayed in the answer form. This is used only for code questions.

	* **Partial Grading** - Click this checkbox to enable partial grading feature.

	* **File** - File field is used to upload files if there is any file based question.
		For e.g. The question is reading a file say **dummy.txt** and print its content.
		You can then upload a file **dummy.txt** which will be available to the student while attempting the quiz.

		* Some file features:
			1. To delete a file click the delete checkbox and click on Delete Selected Files button.
			2. To extract a file for e.g. say **dummy.zip** click the extract checkbox and click on Save button.
				If **extract** is selected, the file will be extracted while checking
				the student submitted code.
			3. To hide any file from student click the hide checkbox and click on Save button.

		.. Note::  We only support **zip** extension for **extract file** feature.


How to write Test cases
-----------------------
	
	The following explains different methods to write test cases.

	* **Create Standard Test Case**

		Select Standard from Add Test Case field.

		* For Python:
			.. image:: ../images/python_standard_testcase.jpg
			   :width: 80%

			In the test case field write a python assert to check the user code.
			For e.g. :: 
				
				assert add(1, 2) == 3
			
			for program of addition.

		* For C, C++, Java and Bash:
			In Test Case Field write the code as follows

			For C and C++:
				.. image:: ../images/cpp_standard_testcase.jpg
					:width: 80%

				Consider a Program to add three numbers.
				The code in the Test case field should be as follows: ::

					#include <stdio.h>
					#include <stdlib.h>

					extern int add(int, int, int);

					template <class T>
					void check(T expect,T result)
					{
						if (expect == result)
						{
						printf("\nCorrect:\n Expected %d got %d \n",expect,result);
						}
						else
						{
						printf("\nIncorrect:\n Expected %d got %d \n",expect,result);
						exit (1);
						}
					}

					int main(void)
					{
						int result;
						result = add(0,0,0);
						printf("Input submitted to the function: 0, 0, 0");
						check(0, result);
						result = add(2,3,3);
						printf("Input submitted to the function: 2, 3, 3");
						check(8,result);
						printf("All Correct\n");
					}

				Assuming Students answer to be as below: ::

					int add(int a, int b, int c)
					{
						return a+b+c;
					}

				.. Note::  1. In the above example, **add** in the main function is obtained from student code.
						2. Please make sure that the student code function and testcase calling function should be same which in this case is **add**.

			For Java:
				.. image:: ../images/java_standard_testcase.jpg
					:width: 80%

				Consider a Program to find square of a number.
				The code in the test should be as follows: ::
					class main
					{
						public static <E> void check(E expect, E result)
						{
							if(result.equals(expect))
							{
								System.out.println("Correct:\nOutput expected "+expect+" and got "+result);
							}
							else
							{
								System.out.println("Incorrect:\nOutput expected "+expect+" but got "+result);
								System.exit(1);
							}
						}
						public static void main(String arg[])
						{
							Test t = new Test();
							int result, input, output;
							input = 0; output = 0;
							result = t.square_num(input);
							System.out.println("Input submitted to the function: "+input);
							check(output, result);
							input = 5; output = 25;
							result = t.square_num(input);
							System.out.println("Input submitted to the function: "+input);
							check(output, result);
							input = 6; output = 36;
							result = t.square_num(input);
							System.out.println("Input submitted to the function: "+input);
							check(output, result);
						}
					}

				Assuming Students answer to be as below: ::

					class Test
					{
						int square_num(int num)
						{
							return num*num;
						}
					}

				.. Note::	1. For Java, class name should always be **main** in testcase.

							2. In the above example, **Test** is the class of student's code.
							3. Please make sure that the student's code class and   calling class in testcase is always **Test**. (square_num is the function inside Test class.)

			For Bash:
				.. image:: ../images/bash_standard_testcase.jpg
					:width: 80%

				In **Test case** Field write your bash script.
					For e.g. the question is to move to a particular directory and read a file
					**test.txt**
					The Test case code shown is: ::

						#!/bin/bash
						cd $1
						cat $2

				In **Test case args** Field type your Command line arguments.

					In this case the test case args are: ::

						somedata/  test.txt

					.. Note:: 1. **Test case args** field is used only for bash.
							  2. Each argument should be separated by **space**.
							  3. This field can be left blank.


		Check Delete Field if a test case is to be removed.

		Finally click on Save to save the test case.


	* **Create Standard Input/Output Based Test Case**
            
			Select StdIO from Add Test Case field.

				.. image:: ../images/stdio_testcase.jpg
					:width: 80%

			In Expected input field, enter the value(s) that will be passed to the students' code through a standard I/O stream.

			.. note::  If there are multiple input values in a test case, enter the values in new line.

			In Expected Output Field, enter the expected output for that test case. For e.g type 3 if the output of the user code is 3.

			Setting up Standard Input/Output Based questions is same for all languages.

	* **Create MCQ or MCC Based Test Case**

		Select MCQ/MCC from Add Test Case field.

			Fig (a) showing MCQ based testcase

			.. image:: ../images/mcq_testcase.jpg
				:width: 80%

			Fig (b) showing MCC based testcase

			.. image:: ../images/mcc_testcase.jpg
				:width: 80%

		In Options Field type the option check the correct checkbox if the current option is correct and click on Save button to save each option.

		For MCC based question, check the correct checkbox for multiple correct options.


Features in Question
--------------------
	
	* **Download Questions**

			Select questions from the list of question displayed on the Questions page. Click on the Download Selected button to download the questions. This will create a zip file of the Questions selected.

	* **Upload Questions**
			
			Click on the browse button. This will open up a window. Select the zip file of questions and click Ok and then click on Upload file button, questions will be uploaded and displayed on the Questions page.

	* **Test Questions**
			
			Select questions from the list of question displayed on the Questions page. Click on Test selected button. This will take you to a quiz with the selected questions. 

			.. Note:: This will not create an actual quiz but a trial quiz. This quiz is hidden from the students and only for moderator to view. You can delete the quiz from moderator's dashboard.

	* **Filter Questions**
			
			You can filter questions based on type of question, language of question or marks of question.
				1. Click Select Question Type to filter question based on type of the question.
				2. Click Select Language to filter question based on language of the question.
				3. Click Select marks to filter question based on mark of the question.