diff options
Diffstat (limited to 'yaksh/documentation')
33 files changed, 606 insertions, 21 deletions
diff --git a/yaksh/documentation/_build/doctrees/about_yaksh.doctree b/yaksh/documentation/_build/doctrees/about_yaksh.doctree Binary files differindex 0d305f6..f0ae4ee 100644 --- a/yaksh/documentation/_build/doctrees/about_yaksh.doctree +++ b/yaksh/documentation/_build/doctrees/about_yaksh.doctree diff --git a/yaksh/documentation/_build/doctrees/environment.pickle b/yaksh/documentation/_build/doctrees/environment.pickle Binary files differindex abab6e4..0832fd0 100644 --- a/yaksh/documentation/_build/doctrees/environment.pickle +++ b/yaksh/documentation/_build/doctrees/environment.pickle diff --git a/yaksh/documentation/_build/doctrees/index.doctree b/yaksh/documentation/_build/doctrees/index.doctree Binary files differindex e195f6a..a583eca 100644 --- a/yaksh/documentation/_build/doctrees/index.doctree +++ b/yaksh/documentation/_build/doctrees/index.doctree diff --git a/yaksh/documentation/_build/doctrees/installation.doctree b/yaksh/documentation/_build/doctrees/installation.doctree Binary files differindex 458b233..565532f 100644 --- a/yaksh/documentation/_build/doctrees/installation.doctree +++ b/yaksh/documentation/_build/doctrees/installation.doctree diff --git a/yaksh/documentation/_build/doctrees/introduction.doctree b/yaksh/documentation/_build/doctrees/introduction.doctree Binary files differindex bc06f06..443d70e 100644 --- a/yaksh/documentation/_build/doctrees/introduction.doctree +++ b/yaksh/documentation/_build/doctrees/introduction.doctree diff --git a/yaksh/documentation/_build/doctrees/moderator_dashboard.doctree b/yaksh/documentation/_build/doctrees/moderator_dashboard.doctree Binary files differindex ad55c2b..384f5ef 100644 --- a/yaksh/documentation/_build/doctrees/moderator_dashboard.doctree +++ b/yaksh/documentation/_build/doctrees/moderator_dashboard.doctree diff --git a/yaksh/documentation/_build/doctrees/moderator_docs/creating_course.doctree b/yaksh/documentation/_build/doctrees/moderator_docs/creating_course.doctree Binary files differindex 19a4d6e..bc3d03f 100644 --- a/yaksh/documentation/_build/doctrees/moderator_docs/creating_course.doctree +++ b/yaksh/documentation/_build/doctrees/moderator_docs/creating_course.doctree diff --git a/yaksh/documentation/_build/doctrees/moderator_docs/creating_question.doctree b/yaksh/documentation/_build/doctrees/moderator_docs/creating_question.doctree Binary files differindex 4a3c1f3..6a50b0c 100644 --- a/yaksh/documentation/_build/doctrees/moderator_docs/creating_question.doctree +++ b/yaksh/documentation/_build/doctrees/moderator_docs/creating_question.doctree diff --git a/yaksh/documentation/_build/doctrees/moderator_docs/creating_quiz.doctree b/yaksh/documentation/_build/doctrees/moderator_docs/creating_quiz.doctree Binary files differindex dbff1d1..6f6ac1c 100644 --- a/yaksh/documentation/_build/doctrees/moderator_docs/creating_quiz.doctree +++ b/yaksh/documentation/_build/doctrees/moderator_docs/creating_quiz.doctree diff --git a/yaksh/documentation/_build/doctrees/moderator_docs/other_features.doctree b/yaksh/documentation/_build/doctrees/moderator_docs/other_features.doctree Binary files differnew file mode 100644 index 0000000..3cddad3 --- /dev/null +++ b/yaksh/documentation/_build/doctrees/moderator_docs/other_features.doctree diff --git a/yaksh/documentation/_build/html/_images/add_question.jpg b/yaksh/documentation/_build/html/_images/add_question.jpg Binary files differnew file mode 100644 index 0000000..a4b343e --- /dev/null +++ b/yaksh/documentation/_build/html/_images/add_question.jpg diff --git a/yaksh/documentation/_build/html/_images/questions.jpg b/yaksh/documentation/_build/html/_images/questions.jpg Binary files differnew file mode 100644 index 0000000..6bc4ea2 --- /dev/null +++ b/yaksh/documentation/_build/html/_images/questions.jpg diff --git a/yaksh/documentation/_build/html/_images/setting_question.jpg b/yaksh/documentation/_build/html/_images/setting_question.jpg Binary files differnew file mode 100644 index 0000000..6bc4ea2 --- /dev/null +++ b/yaksh/documentation/_build/html/_images/setting_question.jpg diff --git a/yaksh/documentation/_build/html/_sources/moderator_dashboard.txt b/yaksh/documentation/_build/html/_sources/moderator_dashboard.txt index a4b2260..a93ea3c 100644 --- a/yaksh/documentation/_build/html/_sources/moderator_dashboard.txt +++ b/yaksh/documentation/_build/html/_sources/moderator_dashboard.txt @@ -13,4 +13,5 @@ The following pages explain the various functions available for moderators moderator_docs/creating_course.rst moderator_docs/creating_quiz.rst - moderator_docs/creating_question.rst
\ No newline at end of file + moderator_docs/creating_question.rst + moderator_docs/other_features.rst
\ No newline at end of file diff --git a/yaksh/documentation/_build/html/_sources/moderator_docs/creating_question.txt b/yaksh/documentation/_build/html/_sources/moderator_docs/creating_question.txt index 5e43b8d..421b3d6 100644 --- a/yaksh/documentation/_build/html/_sources/moderator_docs/creating_question.txt +++ b/yaksh/documentation/_build/html/_sources/moderator_docs/creating_question.txt @@ -2,5 +2,90 @@ 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. + + * **Active** - If the question is active to attempt or not. + + * **Type** - Type of the question. i.e Multiple Choice, Multiple Correct Choice, Code and Assignment Upload. + + * **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. + + * **Test case type** - Test cases or answers are to be added. There are multiple type of test cases - + + * Standard Test Case which is an assertion based testcase. + * Stdout Based Test Case is stdout based test where moderator can provide expected output (Only for Python). + * MCQ Based Test Case is testcase for Mcqs and Mccs. + +How to write Test cases +----------------------- + + The following explains different methods to write test cases. + + * **Create Standard Test Case** + + Select Standard Test Case and click on Save & Add Testcase button to save the question. + + * For Python: + In the test case field write a python assert to check the user code. + For e.g. :: + + assert fact(3) == 6 + + for program of factorial. + + * For C, C++ and Java: + In Test Case Field add the test case file path. + + Check Delete Field if a test case is to be removed. + + Finally click on Save & Add Testcase Button to save the test case. + + + * **Create Standard out Based Test Case** + + Select Stdout Based TestCase from Test Case Type field and click on Save & Add Testcase button to save the question. + + In Expected Output Field type the expected output for a particular question. For e.g type 6 if the output of the user code is 6. + + * **Create MCQ Based Test Case** + + Select MCQ Based TestCase from Test Case Type field and click on Save & Add Testcase button to save the question. + + In Options Field type the option check the correct checkbox if the current option is correct and click on Save & Add Testcase button to save each option. + + +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 json file of the Questions selected. + + * **Upload Questions** + + Click on the Upload File button. This will open up a window. Select the json file of questions and click Ok and the 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.
\ No newline at end of file diff --git a/yaksh/documentation/_build/html/_sources/moderator_docs/creating_quiz.txt b/yaksh/documentation/_build/html/_sources/moderator_docs/creating_quiz.txt index bf82e4d..de0f031 100644 --- a/yaksh/documentation/_build/html/_sources/moderator_docs/creating_quiz.txt +++ b/yaksh/documentation/_build/html/_sources/moderator_docs/creating_quiz.txt @@ -11,7 +11,7 @@ Creating a Quiz --------------- .. image:: ../images/add_quiz.jpg - .. note :: It is important to have created or uploaded questions before creating a quiz. Click here to know how to add questions. + .. note :: It is important to have created or uploaded questions before creating a quiz. In courses click on **Add Quiz** button to add a quiz. diff --git a/yaksh/documentation/_build/html/_sources/moderator_docs/other_features.txt b/yaksh/documentation/_build/html/_sources/moderator_docs/other_features.txt new file mode 100644 index 0000000..2e670ac --- /dev/null +++ b/yaksh/documentation/_build/html/_sources/moderator_docs/other_features.txt @@ -0,0 +1,20 @@ +============== +Other Features +============== + +Grade User +---------- + + Grade User is a feature of Yaksh to access students' answer papers for each quiz and grade them where necessary. + +Monitor +------- + + Monitor is a feature of Yaksh where the moderator can monitor a quiz and view statistics. + +Trial Papers +------------ + + When a moderator attempts a quiz in User or God mode or tests questions, a trial answer paper is created. Moderator can check the answer paper. + + .. note:: It is advisable to delete these trial answer papers.
\ No newline at end of file diff --git a/yaksh/documentation/_build/html/about_yaksh.html b/yaksh/documentation/_build/html/about_yaksh.html index dc33607..c8f4f90 100644 --- a/yaksh/documentation/_build/html/about_yaksh.html +++ b/yaksh/documentation/_build/html/about_yaksh.html @@ -31,7 +31,7 @@ <link rel="top" title="Yaksh July 2016 documentation" href="index.html"/> - <link rel="prev" title="Moderator’s Dashboard" href="moderator_dashboard.html"/> + <link rel="prev" title="Questions" href="moderator_docs/creating_question.html"/> <script src="_static/js/modernizr.min.js"></script> @@ -167,7 +167,7 @@ Copyright (c) 2011 FOSSEE (fossee.in)</p> <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation"> - <a href="moderator_dashboard.html" class="btn btn-neutral" title="Moderator’s Dashboard" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous</a> + <a href="moderator_docs/creating_question.html" class="btn btn-neutral" title="Questions" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous</a> </div> diff --git a/yaksh/documentation/_build/html/index.html b/yaksh/documentation/_build/html/index.html index fa2b1f8..0f967dc 100644 --- a/yaksh/documentation/_build/html/index.html +++ b/yaksh/documentation/_build/html/index.html @@ -160,7 +160,18 @@ <li class="toctree-l3"><a class="reference internal" href="moderator_docs/creating_quiz.html#editing-a-quiz">Editing a Quiz</a></li> </ul> </li> -<li class="toctree-l2"><a class="reference internal" href="moderator_docs/creating_question.html">Questions</a></li> +<li class="toctree-l2"><a class="reference internal" href="moderator_docs/creating_question.html">Questions</a><ul> +<li class="toctree-l3"><a class="reference internal" href="moderator_docs/creating_question.html#setting-up-questions">Setting up questions</a></li> +<li class="toctree-l3"><a class="reference internal" href="moderator_docs/creating_question.html#how-to-write-test-cases">How to write Test cases</a></li> +<li class="toctree-l3"><a class="reference internal" href="moderator_docs/creating_question.html#features-in-question">Features in Question</a></li> +</ul> +</li> +<li class="toctree-l2"><a class="reference internal" href="moderator_docs/other_features.html">Other Features</a><ul> +<li class="toctree-l3"><a class="reference internal" href="moderator_docs/other_features.html#grade-user">Grade User</a></li> +<li class="toctree-l3"><a class="reference internal" href="moderator_docs/other_features.html#monitor">Monitor</a></li> +<li class="toctree-l3"><a class="reference internal" href="moderator_docs/other_features.html#trial-papers">Trial Papers</a></li> +</ul> +</li> </ul> </li> <li class="toctree-l1"><a class="reference internal" href="about_yaksh.html">About Yaksh</a><ul> diff --git a/yaksh/documentation/_build/html/introduction.html b/yaksh/documentation/_build/html/introduction.html index 6b92966..8be4004 100644 --- a/yaksh/documentation/_build/html/introduction.html +++ b/yaksh/documentation/_build/html/introduction.html @@ -87,8 +87,7 @@ </ul> </li> <li class="toctree-l1"><a class="reference internal" href="installation.html">Installation</a></li> -<li class="toctree-l1"><a class="reference internal" href="installation.html#quick-start">Quick Start</a></li> -<li class="toctree-l1"><a class="reference internal" href="moderator_dashboard.html">2. Moderator’s Dashboard</a></li> +<li class="toctree-l1"><a class="reference internal" href="moderator_dashboard.html">Moderator’s Dashboard</a></li> <li class="toctree-l1"><a class="reference internal" href="about_yaksh.html">About Yaksh</a></li> </ul> diff --git a/yaksh/documentation/_build/html/moderator_dashboard.html b/yaksh/documentation/_build/html/moderator_dashboard.html index 01183b6..2eac65f 100644 --- a/yaksh/documentation/_build/html/moderator_dashboard.html +++ b/yaksh/documentation/_build/html/moderator_dashboard.html @@ -88,6 +88,7 @@ <li class="toctree-l2"><a class="reference internal" href="moderator_docs/creating_course.html">Courses</a></li> <li class="toctree-l2"><a class="reference internal" href="moderator_docs/creating_quiz.html">Quizzes</a></li> <li class="toctree-l2"><a class="reference internal" href="moderator_docs/creating_question.html">Questions</a></li> +<li class="toctree-l2"><a class="reference internal" href="moderator_docs/other_features.html">Other Features</a></li> </ul> </li> <li class="toctree-l1"><a class="reference internal" href="about_yaksh.html">About Yaksh</a></li> @@ -153,7 +154,18 @@ <li class="toctree-l2"><a class="reference internal" href="moderator_docs/creating_quiz.html#editing-a-quiz">Editing a Quiz</a></li> </ul> </li> -<li class="toctree-l1"><a class="reference internal" href="moderator_docs/creating_question.html">Questions</a></li> +<li class="toctree-l1"><a class="reference internal" href="moderator_docs/creating_question.html">Questions</a><ul> +<li class="toctree-l2"><a class="reference internal" href="moderator_docs/creating_question.html#setting-up-questions">Setting up questions</a></li> +<li class="toctree-l2"><a class="reference internal" href="moderator_docs/creating_question.html#how-to-write-test-cases">How to write Test cases</a></li> +<li class="toctree-l2"><a class="reference internal" href="moderator_docs/creating_question.html#features-in-question">Features in Question</a></li> +</ul> +</li> +<li class="toctree-l1"><a class="reference internal" href="moderator_docs/other_features.html">Other Features</a><ul> +<li class="toctree-l2"><a class="reference internal" href="moderator_docs/other_features.html#grade-user">Grade User</a></li> +<li class="toctree-l2"><a class="reference internal" href="moderator_docs/other_features.html#monitor">Monitor</a></li> +<li class="toctree-l2"><a class="reference internal" href="moderator_docs/other_features.html#trial-papers">Trial Papers</a></li> +</ul> +</li> </ul> </div> </div> diff --git a/yaksh/documentation/_build/html/moderator_docs/creating_course.html b/yaksh/documentation/_build/html/moderator_docs/creating_course.html index 7a88c85..aaf38f0 100644 --- a/yaksh/documentation/_build/html/moderator_docs/creating_course.html +++ b/yaksh/documentation/_build/html/moderator_docs/creating_course.html @@ -32,7 +32,7 @@ <link rel="top" title="Yaksh July 2016 documentation" href="../index.html"/> <link rel="up" title="Moderator’s Dashboard" href="../moderator_dashboard.html"/> - <link rel="next" title="Creating a Quiz" href="creating_quiz.html"/> + <link rel="next" title="Quizzes" href="creating_quiz.html"/> <link rel="prev" title="Moderator’s Dashboard" href="../moderator_dashboard.html"/> @@ -91,7 +91,7 @@ <li class="toctree-l3"><a class="reference internal" href="#features-in-courses">Features in Courses</a></li> </ul> </li> -<li class="toctree-l2"><a class="reference internal" href="creating_quiz.html">Creating a Quiz</a></li> +<li class="toctree-l2"><a class="reference internal" href="creating_quiz.html">Quizzes</a></li> <li class="toctree-l2"><a class="reference internal" href="creating_question.html">Questions</a></li> </ul> </li> @@ -218,7 +218,7 @@ <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation"> - <a href="creating_quiz.html" class="btn btn-neutral float-right" title="Creating a Quiz" accesskey="n">Next <span class="fa fa-arrow-circle-right"></span></a> + <a href="creating_quiz.html" class="btn btn-neutral float-right" title="Quizzes" accesskey="n">Next <span class="fa fa-arrow-circle-right"></span></a> <a href="../moderator_dashboard.html" class="btn btn-neutral" title="Moderator’s Dashboard" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous</a> diff --git a/yaksh/documentation/_build/html/moderator_docs/creating_question.html b/yaksh/documentation/_build/html/moderator_docs/creating_question.html index 0b740ff..e163850 100644 --- a/yaksh/documentation/_build/html/moderator_docs/creating_question.html +++ b/yaksh/documentation/_build/html/moderator_docs/creating_question.html @@ -32,8 +32,8 @@ <link rel="top" title="Yaksh July 2016 documentation" href="../index.html"/> <link rel="up" title="Moderator’s Dashboard" href="../moderator_dashboard.html"/> - <link rel="next" title="About Yaksh" href="../about_yaksh.html"/> - <link rel="prev" title="Creating a Quiz" href="creating_quiz.html"/> + <link rel="next" title="Other Features" href="other_features.html"/> + <link rel="prev" title="Quizzes" href="creating_quiz.html"/> <script src="../_static/js/modernizr.min.js"></script> @@ -87,8 +87,14 @@ <li class="toctree-l1"><a class="reference internal" href="../installation.html">Installation</a></li> <li class="toctree-l1 current"><a class="reference internal" href="../moderator_dashboard.html">Moderator’s Dashboard</a><ul class="current"> <li class="toctree-l2"><a class="reference internal" href="creating_course.html">Courses</a></li> -<li class="toctree-l2"><a class="reference internal" href="creating_quiz.html">Creating a Quiz</a></li> -<li class="toctree-l2 current"><a class="current reference internal" href="#">Questions</a></li> +<li class="toctree-l2"><a class="reference internal" href="creating_quiz.html">Quizzes</a></li> +<li class="toctree-l2 current"><a class="current reference internal" href="#">Questions</a><ul> +<li class="toctree-l3"><a class="reference internal" href="#setting-up-questions">Setting up questions</a></li> +<li class="toctree-l3"><a class="reference internal" href="#how-to-write-test-cases">How to write Test cases</a></li> +<li class="toctree-l3"><a class="reference internal" href="#features-in-question">Features in Question</a></li> +</ul> +</li> +<li class="toctree-l2"><a class="reference internal" href="other_features.html">Other Features</a></li> </ul> </li> <li class="toctree-l1"><a class="reference internal" href="../about_yaksh.html">About Yaksh</a></li> @@ -140,6 +146,110 @@ <div class="section" id="questions"> <h1>Questions<a class="headerlink" href="#questions" title="Permalink to this headline">¶</a></h1> +<div class="section" id="setting-up-questions"> +<h2>Setting up questions<a class="headerlink" href="#setting-up-questions" title="Permalink to this headline">¶</a></h2> +<blockquote> +<div><p>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.</p> +<p>To set up a question click on the questions link in the navigation bar.</p> +<img alt="../_images/questions.jpg" src="../_images/questions.jpg" /> +<p>To add a question click on the <strong>Add Question</strong> button</p> +<img alt="../_images/add_question.jpg" src="../_images/add_question.jpg" /> +<ul class="simple"> +<li><strong>Summary</strong>- Summary or the name of the question.</li> +<li><strong>Language</strong> - Programming language on which the question is based.</li> +<li><strong>Active</strong> - If the question is active to attempt or not.</li> +<li><strong>Type</strong> - Type of the question. i.e Multiple Choice, Multiple Correct Choice, Code and Assignment Upload.</li> +<li><strong>Description</strong> - The actual question description is to be written.</li> +</ul> +<div class="admonition note"> +<p class="first admonition-title">Note</p> +<p class="last">To add codes in questions please use html <code> and <br> tags.</p> +</div> +<ul> +<li><p class="first"><strong>Tags</strong> - Type of label or metadata tag making it easier to find specific type of questions.</p> +</li> +<li><p class="first">** 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.</p> +</li> +<li><p class="first"><strong>Test case type</strong> - Test cases or answers are to be added. There are multiple type of test cases -</p> +<blockquote> +<div><ul class="simple"> +<li>Standard Test Case which is an assertion based testcase.</li> +<li>Stdout Based Test Case is stdout based test where moderator can provide expected output (Only for Python).</li> +<li>MCQ Based Test Case is testcase for Mcqs and Mccs.</li> +</ul> +</div></blockquote> +</li> +</ul> +</div></blockquote> +</div> +<div class="section" id="how-to-write-test-cases"> +<h2>How to write Test cases<a class="headerlink" href="#how-to-write-test-cases" title="Permalink to this headline">¶</a></h2> +<blockquote> +<div><p>The following explains different methods to write test cases.</p> +<ul> +<li><p class="first"><strong>Create Standard Test Case</strong></p> +<blockquote> +<div><p>Select Standard Test Case and click on Save & Add Testcase button to save the question.</p> +<ul> +<li><dl class="first docutils"> +<dt>For Python:</dt> +<dd><p class="first">In the test case field write a python assert to check the user code. +For e.g.</p> +<div class="highlight-default"><div class="highlight"><pre><span></span><span class="k">assert</span> <span class="n">fact</span><span class="p">(</span><span class="mi">3</span><span class="p">)</span> <span class="o">==</span> <span class="mi">6</span> +</pre></div> +</div> +<p class="last">for program of factorial.</p> +</dd> +</dl> +</li> +<li><dl class="first docutils"> +<dt>For C, C++ and Java:</dt> +<dd><p class="first last">In Test Case Field add the test case file path.</p> +</dd> +</dl> +</li> +</ul> +<p>Check Delete Field if a test case is to be removed.</p> +<p>Finally click on Save & Add Testcase Button to save the test case.</p> +</div></blockquote> +</li> +<li><p class="first"><strong>Create Standard out Based Test Case</strong></p> +<blockquote> +<div><p>Select Stdout Based TestCase from Test Case Type field and click on Save & Add Testcase button to save the question.</p> +<p>In Expected Output Field type the expected output for a particular question. For e.g type 6 if the output of the user code is 6.</p> +</div></blockquote> +</li> +<li><p class="first"><strong>Create MCQ Based Test Case</strong></p> +<blockquote> +<div><p>Select MCQ Based TestCase from Test Case Type field and click on Save & Add Testcase button to save the question.</p> +<p>In Options Field type the option check the correct checkbox if the current option is correct and click on Save & Add Testcase button to save each option.</p> +</div></blockquote> +</li> +</ul> +</div></blockquote> +</div> +<div class="section" id="features-in-question"> +<h2>Features in Question<a class="headerlink" href="#features-in-question" title="Permalink to this headline">¶</a></h2> +<blockquote> +<div><ul> +<li><p class="first"><strong>Download Questions</strong></p> +<blockquote> +<div><p>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 json file of the Questions selected.</p> +</div></blockquote> +</li> +<li><p class="first"><strong>Upload Questions</strong></p> +<blockquote> +<div><p>Click on the Upload File button. This will open up a window. Select the json file of questions and click Ok and the questions will be uploaded and displayed on the Questions page.</p> +</div></blockquote> +</li> +<li><p class="first"><strong>Test Questions</strong></p> +<blockquote> +<div><p>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. <strong>Note</strong> - 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.</p> +</div></blockquote> +</li> +</ul> +</div></blockquote> +</div> </div> @@ -149,10 +259,10 @@ <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation"> - <a href="../about_yaksh.html" class="btn btn-neutral float-right" title="About Yaksh" accesskey="n">Next <span class="fa fa-arrow-circle-right"></span></a> + <a href="other_features.html" class="btn btn-neutral float-right" title="Other Features" accesskey="n">Next <span class="fa fa-arrow-circle-right"></span></a> - <a href="creating_quiz.html" class="btn btn-neutral" title="Creating a Quiz" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous</a> + <a href="creating_quiz.html" class="btn btn-neutral" title="Quizzes" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous</a> </div> diff --git a/yaksh/documentation/_build/html/moderator_docs/creating_quiz.html b/yaksh/documentation/_build/html/moderator_docs/creating_quiz.html index 4ab5edc..ba675f7 100644 --- a/yaksh/documentation/_build/html/moderator_docs/creating_quiz.html +++ b/yaksh/documentation/_build/html/moderator_docs/creating_quiz.html @@ -94,6 +94,7 @@ </ul> </li> <li class="toctree-l2"><a class="reference internal" href="creating_question.html">Questions</a></li> +<li class="toctree-l2"><a class="reference internal" href="other_features.html">Other Features</a></li> </ul> </li> <li class="toctree-l1"><a class="reference internal" href="../about_yaksh.html">About Yaksh</a></li> @@ -152,7 +153,7 @@ <div><img alt="../_images/add_quiz.jpg" src="../_images/add_quiz.jpg" /> <div class="admonition note"> <p class="first admonition-title">Note</p> -<p class="last">It is important to have created or uploaded questions before creating a quiz. Click here to know how to add questions.</p> +<p class="last">It is important to have created or uploaded questions before creating a quiz.</p> </div> <p>In courses click on <strong>Add Quiz</strong> button to add a quiz.</p> <ul class="simple"> diff --git a/yaksh/documentation/_build/html/moderator_docs/other_features.html b/yaksh/documentation/_build/html/moderator_docs/other_features.html new file mode 100644 index 0000000..83d251d --- /dev/null +++ b/yaksh/documentation/_build/html/moderator_docs/other_features.html @@ -0,0 +1,240 @@ + + +<!DOCTYPE html> +<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]--> +<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]--> +<head> + <meta charset="utf-8"> + + <meta name="viewport" content="width=device-width, initial-scale=1.0"> + + <title>Other Features — Yaksh July 2016 documentation</title> + + + + + + + + + + + + + + + + <link rel="stylesheet" href="../_static/css/theme.css" type="text/css" /> + + + + + + <link rel="top" title="Yaksh July 2016 documentation" href="../index.html"/> + <link rel="up" title="Moderator’s Dashboard" href="../moderator_dashboard.html"/> + <link rel="next" title="About Yaksh" href="../about_yaksh.html"/> + <link rel="prev" title="Questions" href="creating_question.html"/> + + + <script src="../_static/js/modernizr.min.js"></script> + +</head> + +<body class="wy-body-for-nav" role="document"> + + <div class="wy-grid-for-nav"> + + + <nav data-toggle="wy-nav-shift" class="wy-nav-side"> + <div class="wy-side-scroll"> + <div class="wy-side-nav-search"> + + + + <a href="../index.html" class="icon icon-home"> Yaksh + + + + </a> + + + + + <div class="version"> + 0.1.2 + </div> + + + + +<div role="search"> + <form id="rtd-search-form" class="wy-form" action="../search.html" method="get"> + <input type="text" name="q" placeholder="Search docs" /> + <input type="hidden" name="check_keywords" value="yes" /> + <input type="hidden" name="area" value="default" /> + </form> +</div> + + + </div> + + <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation"> + + + + <ul class="current"> +<li class="toctree-l1"><a class="reference internal" href="../introduction.html">Introduction</a></li> +<li class="toctree-l1"><a class="reference internal" href="../installation.html">Installation</a></li> +<li class="toctree-l1 current"><a class="reference internal" href="../moderator_dashboard.html">Moderator’s Dashboard</a><ul class="current"> +<li class="toctree-l2"><a class="reference internal" href="creating_course.html">Courses</a></li> +<li class="toctree-l2"><a class="reference internal" href="creating_quiz.html">Quizzes</a></li> +<li class="toctree-l2"><a class="reference internal" href="creating_question.html">Questions</a></li> +<li class="toctree-l2 current"><a class="current reference internal" href="#">Other Features</a><ul> +<li class="toctree-l3"><a class="reference internal" href="#grade-user">Grade User</a></li> +<li class="toctree-l3"><a class="reference internal" href="#monitor">Monitor</a></li> +<li class="toctree-l3"><a class="reference internal" href="#trial-papers">Trial Papers</a></li> +</ul> +</li> +</ul> +</li> +<li class="toctree-l1"><a class="reference internal" href="../about_yaksh.html">About Yaksh</a></li> +</ul> + + + + </div> + </div> + </nav> + + <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"> + + + <nav class="wy-nav-top" role="navigation" aria-label="top navigation"> + <i data-toggle="wy-nav-top" class="fa fa-bars"></i> + <a href="../index.html">Yaksh</a> + </nav> + + + + <div class="wy-nav-content"> + <div class="rst-content"> + + + + + + +<div role="navigation" aria-label="breadcrumbs navigation"> + <ul class="wy-breadcrumbs"> + <li><a href="../index.html">Docs</a> »</li> + + <li><a href="../moderator_dashboard.html">Moderator’s Dashboard</a> »</li> + + <li>Other Features</li> + <li class="wy-breadcrumbs-aside"> + + + <a href="../_sources/moderator_docs/other_features.txt" rel="nofollow"> View page source</a> + + + </li> + </ul> + <hr/> +</div> + <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article"> + <div itemprop="articleBody"> + + <div class="section" id="other-features"> +<h1>Other Features<a class="headerlink" href="#other-features" title="Permalink to this headline">¶</a></h1> +<div class="section" id="grade-user"> +<h2>Grade User<a class="headerlink" href="#grade-user" title="Permalink to this headline">¶</a></h2> +<blockquote> +<div>Grade User is a feature of Yaksh to access students’ answer papers for each quiz and grade them where necessary.</div></blockquote> +</div> +<div class="section" id="monitor"> +<h2>Monitor<a class="headerlink" href="#monitor" title="Permalink to this headline">¶</a></h2> +<blockquote> +<div>Monitor is a feature of Yaksh where the moderator can monitor a quiz and view statistics.</div></blockquote> +</div> +<div class="section" id="trial-papers"> +<h2>Trial Papers<a class="headerlink" href="#trial-papers" title="Permalink to this headline">¶</a></h2> +<blockquote> +<div><p>When a moderator attempts a quiz in User or God mode or tests questions, a trial answer paper is created. Moderator can check the answer paper.</p> +<div class="admonition note"> +<p class="first admonition-title">Note</p> +<p class="last">It is advisable to delete these trial answer papers.</p> +</div> +</div></blockquote> +</div> +</div> + + + </div> + </div> + <footer> + + <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation"> + + <a href="../about_yaksh.html" class="btn btn-neutral float-right" title="About Yaksh" accesskey="n">Next <span class="fa fa-arrow-circle-right"></span></a> + + + <a href="creating_question.html" class="btn btn-neutral" title="Questions" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous</a> + + </div> + + + <hr/> + + <div role="contentinfo"> + <p> + © Copyright 2016, FOSSEE. + + </p> + </div> + Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>. + +</footer> + + </div> + </div> + + </section> + + </div> + + + + + + <script type="text/javascript"> + var DOCUMENTATION_OPTIONS = { + URL_ROOT:'../', + VERSION:'July 2016', + COLLAPSE_INDEX:false, + FILE_SUFFIX:'.html', + HAS_SOURCE: true + }; + </script> + <script type="text/javascript" src="../_static/jquery.js"></script> + <script type="text/javascript" src="../_static/underscore.js"></script> + <script type="text/javascript" src="../_static/doctools.js"></script> + <script type="text/javascript" src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script> + + + + + + <script type="text/javascript" src="../_static/js/theme.js"></script> + + + + + <script type="text/javascript"> + jQuery(function () { + SphinxRtdTheme.StickyNav.enable(); + }); + </script> + + +</body> +</html>
\ No newline at end of file diff --git a/yaksh/documentation/_build/html/objects.inv b/yaksh/documentation/_build/html/objects.inv Binary files differindex 57c13df..7e8bf90 100644 --- a/yaksh/documentation/_build/html/objects.inv +++ b/yaksh/documentation/_build/html/objects.inv diff --git a/yaksh/documentation/_build/html/searchindex.js b/yaksh/documentation/_build/html/searchindex.js index e479904..1b2f4eb 100644 --- a/yaksh/documentation/_build/html/searchindex.js +++ b/yaksh/documentation/_build/html/searchindex.js @@ -1 +1 @@ -Search.setIndex({envversion:49,filenames:["about_yaksh","index","installation","introduction","moderator_dashboard","moderator_docs/creating_course","moderator_docs/creating_question","moderator_docs/creating_quiz"],objects:{},objnames:{},objtypes:{},terms:{"case":[2,3],"default":2,"function":4,"import":7,"new":2,about:[],accept:5,activ:[5,7],active:[5,7],add:[5,7],adding:[],admin:2,administ:0,after:7,all:5,allot:5,allote:[],allow:7,also:[2,7],ani:[3,7],answer:0,anyon:0,apac:0,app:[0,3],appear:7,applic:0,arbitrari:3,associ:7,attempt:7,avail:[1,4,5],bar:5,base:[0,3,7],bash:3,basic:[0,1],been:[0,7],befor:7,between:7,boesch:0,both:7,bottom:0,bound:7,browser:2,bsd:[0,3],built:0,button:[5,7],can:[0,2,5,7],cannot:7,chang:7,check:0,choic:[0,3],chri:0,click:[5,7],code:[0,1,2,3],com:2,comfort:1,complic:3,constraint:7,content:[],contest:0,copyright:0,could:3,cours:[],creat:2,create_demo:2,creator:5,credenti:2,current:[2,7],cut:0,dai:7,dashboard:[],date:7,deactiv:7,defin:3,deploi:[],deploy:[],descript:7,design:[],desir:2,develop:[0,1,2],differ:7,directori:2,displai:[5,7],distribut:[0,3],django:[0,2],durat:7,edit:[2,5,7],edite:[],eligibilti:7,end:7,enrol:5,enroll:5,enrollment:5,ensure:2,enter:2,environ:[],everi:7,exam:[2,3],execut:2,expir:7,explain:4,fairli:3,featur:[],few:1,field:[5,7],file:[0,3],fill:5,first:5,fix:7,flag:2,follow:[2,4,5],fosse:0,fossee:[0,1,2],from:7,fun:0,further:0,gae:0,get:1,git:2,github:[1,2],given:7,god:7,grade:0,guid:[],had:0,have:[0,3,7],hello:[],help:[],henc:[0,7],here:7,how:7,html:[],http:2,idea:0,imag:[],immediat:3,imper:5,implement:[0,3],inact:7,index:[],inform:0,initi:0,initialis:2,inspir:0,instal:2,install:[],installat:[],instanc:[],instead:0,interest:0,interfac:1,intrins:7,jpeg:[],jumbl:7,know:7,languag:7,later:5,latest:2,lead:5,let:[1,3,5],librari:3,licens:3,link:[5,7],list:[5,7],live:0,localhost:2,locat:5,log:4,login:2,machin:0,made:0,maintain:0,mandatori:7,manual:0,mark:7,maxdepth:[],minimum:7,minut:7,mode:7,moder:[],moderator_dashboard:[],modifi:5,modul:[],much:3,multipl:[0,3],name:[2,5,7],navig:[5,7],need:[5,7],nice:0,nishanth:0,normal:7,note:[],notifi:7,now:[0,2],number:7,once:7,onli:5,onlin:[1,3],online_test:2,open:[1,2,5],option:2,organ:1,origin:7,other:5,over:3,page:[4,5,7],paper:[],paramet:7,pass:7,password:2,path:2,percentag:7,pick:7,pip:2,pool:7,prabhu:0,pre:2,prerequisit:7,pretti:3,preview:7,problem:3,product:[],program:[0,1,3,7],progress:1,project:[1,2,3],project_nam:2,provid:[2,3],pycon:0,pypa:[],python:[0,3],pythonsupport:[],question:[0,3],questionpap:[],quick:[],quickstart:[],quiz:[2,3],quizz:[],ramachandran:0,random:7,redirect:7,refactor:0,reject:5,releas:2,request:5,requir:[5,7],requisit:2,rpc:[],rst:[],run:[2,3],run_code_serv:2,run_demo:2,same:7,save:7,saw:0,scale:3,search:[],section:[1,7],see:4,select:7,send:5,sequenc:7,server:2,set:[],setup:[],should:5,show:[],shuffl:7,simpl:3,simultan:3,sinc:[0,3],singpath:0,site:1,skill:0,solut:3,solv:3,sourc:1,specif:5,specifi:2,stabl:2,start:[],statu:5,still:[1,7],strong:[],student:[0,2,3,5,7],sudo:2,support:[0,3],take:[1,2,3,5,7],taken:7,teacher:[2,5],team:0,technic:3,term:0,termin:2,test:[0,3,7],theam:[],them:5,thi:[0,1,2,3,5,7],those:7,though:7,time:7,titlesonli:[],toctre:[],top:0,trial:[],two:7,type:7,under:[0,1,3],upload:[3,7],url:2,user:[1,2,3,7],usernam:2,variou:4,verif:3,version:2,view:[5,7],wai:7,want:[0,7],web:[0,2],well:7,what:0,where:[2,5],which:[5,7],who:0,wish:[],without:7,won:7,worri:0,written:7,wrote:0,yaksh_demo:2,you:[0,3,5,7],your:[0,2,3]},titles:["About Yaksh","Welcome to Yaksh’s documentation!","Installation","Introduction","Moderator’s Dashboard","Courses","Questions","Quizzes"],titleterms:{"new":5,about:0,adding:[],author:0,contact:0,content:[],cours:5,creat:7,dashboard:4,design:7,document:1,edite:7,featur:[3,5],histori:0,indice:[],install:2,installat:2,introduct:3,licens:0,moder:4,paper:7,question:[6,7],questionpap:[],quick:2,quiz:7,quizz:7,set:5,start:2,tabl:[],welcom:1,yaksh:[0,1,2]}})
\ No newline at end of file +Search.setIndex({envversion:49,filenames:["about_yaksh","index","installation","introduction","moderator_dashboard","moderator_docs/creating_course","moderator_docs/creating_question","moderator_docs/creating_quiz","moderator_docs/other_features"],objects:{},objnames:{},objtypes:{},terms:{"case":[2,3],"default":[2,6],"final":6,"function":4,"import":[6,7],"new":[],about:[],accept:5,access:8,activ:[5,6,7],active:[5,6,7],actual:6,add:[5,6,7],adding:[],admin:2,administ:0,advis:8,after:7,all:5,allot:5,allote:[],allow:7,also:[2,7],ani:[3,6,7],answer:[0,6,8],anyon:0,apac:0,app:[0,3],appear:7,applic:0,arbitrari:3,assert:6,assign:6,assignment:6,associ:7,attempt:[6,7,8],avail:[1,4,5],bar:[5,6],base:[0,3,6,7],bash:3,basic:[0,1],been:[0,7],befor:7,between:7,boesch:0,both:7,bottom:0,bound:7,browser:2,bsd:[0,3],built:0,button:[5,6,7],can:[0,2,5,6,7,8],cannot:7,chang:7,check:[0,6,8],checkbox:6,choic:[0,3,6],chri:0,click:[5,6,7],code:[0,1,2,3,6],com:2,comfort:1,command:6,complic:3,constraint:7,content:[],contest:0,copyright:0,correct:6,could:3,cours:[],creat:[],create_demo:2,creating_quest:[],creator:5,credenti:2,current:[2,6,7],cut:0,dai:7,dashboard:[],date:7,deactiv:7,defin:3,delet:[6,8],deploi:[],deploy:[],descript:[6,7],design:[],desir:2,develop:[0,1,2],differ:[6,7],directori:2,displai:[5,6,7],distribut:[0,3],django:[0,2],download:6,durat:7,each:[6,8],easier:6,edit:[2,5,7],edite:[],eligibilti:7,end:7,enrol:5,enroll:5,enrollment:5,ensure:2,enter:2,environ:[],everi:7,exam:[2,3],execut:2,expect:6,experi:6,expir:7,explain:[4,6],fact:6,factori:6,fairli:3,falanafalana:[],featur:[],few:1,field:[5,6,7],file:[0,3,6],fill:5,find:6,first:5,fix:7,flag:2,follow:[2,4,5,6],form:6,fosse:0,fossee:[0,1,2],from:[6,7],fun:0,further:0,gae:0,get:1,git:2,github:[1,2],give:6,given:7,god:[7,8],grade:0,guid:[],had:0,have:[0,3,7],hello:[],help:[],henc:[0,7],here:[],hidden:6,how:[],html:6,http:2,idea:0,imag:[],immediat:3,imper:5,implement:[0,3],inact:7,indent:[],index:[],inform:0,initi:0,initialis:2,inspir:0,instal:2,install:[],installat:[],instanc:[],instead:0,interest:0,interfac:1,intrins:7,java:6,jpeg:[],jpg:[],json:6,jumbl:7,know:[],label:6,languag:[6,7],later:5,latest:2,lead:5,let:[1,3,5],librari:3,licens:[],link:[5,6,7],list:[5,6,7],live:0,localhost:2,locat:5,log:4,login:2,machin:0,made:0,maintain:0,make:6,mandatori:7,manual:0,mark:7,maxdepth:[],mcc:6,mcq:6,mention:[],metadata:6,method:6,minimum:7,minut:7,mode:[7,8],moder:[],moderator_dashboard:[],modifi:5,modul:[],monitor:[],most:6,much:3,multipl:[0,3,6],name:[2,5,6,7],navig:[5,6,7],necessari:8,need:[5,7],newlin:[],nice:0,nishanth:0,normal:7,note:6,notifi:7,now:[0,2],number:7,once:7,onli:[5,6],onlin:[1,3],online_test:2,only:6,open:[1,2,5,6],option:[2,6],organ:1,origin:7,other:5,out:6,output:6,over:3,page:[4,5,6,7],paper:[],paramet:7,part:6,particular:6,pass:7,password:2,path:[2,6],percentag:7,pick:7,pip:2,pleas:6,pool:7,prabhu:0,pre:2,prerequisit:7,pretti:3,preview:7,problem:3,product:[],program:[0,1,3,6,7],progress:1,project:[1,2,3],project_nam:2,provid:[2,3,6],pycon:0,pypa:[],python:[0,3,6],pythonsupport:[],question:[],questionpap:[],quick:[],quickstart:[],quiz:[],quizz:[],ramachandran:0,random:7,redirect:7,refactor:0,reject:5,releas:2,remov:6,request:5,requir:[5,7],requisit:2,role:[],rpc:[],rst:[],run:[2,3],run_code_serv:2,run_demo:2,sai:[],same:7,save:[6,7],saw:0,scale:3,search:[],section:[1,7],see:4,select:[6,7],send:5,sequenc:7,server:2,set:[],setting_quest:[],setup:[],should:5,show:[],shuffl:7,simpl:3,simultan:3,sinc:[0,3],singpath:0,site:1,skill:0,snippet:6,solut:3,solv:3,sourc:1,specif:[5,6],specifi:2,stabl:2,standard:6,start:[],statist:8,statu:5,stdout:6,still:[1,7],strong:[],student:[0,2,3,5,6,7,8],sudo:2,summari:6,support:[0,3],tag:6,take:[1,2,3,5,6,7],taken:7,teacher:[2,5],team:0,technic:3,term:0,termin:2,test:[0,3],testcas:6,theam:[],them:[5,8],thi:[0,1,2,3,5,6,7],those:7,though:7,time:7,titlesonli:[],toctre:[],top:0,trial:[],two:7,type:[6,7],under:[0,1,3],upload:[3,6,7],url:2,user:[2,3],usernam:2,valu:6,variou:4,verif:3,version:2,view:[5,6,7,8],wai:7,want:[0,7],web:[0,2],well:7,what:0,when:8,where:[2,5,6,8],which:[5,6,7],who:0,window:6,wish:[],without:7,won:7,worri:0,write:[],written:[6,7],wrote:0,yaksh_demo:2,you:[0,3,5,6,7],your:[0,2,3]},titles:["About Yaksh","Welcome to Yaksh’s documentation!","Installation","Introduction","Moderator’s Dashboard","Courses","Questions","Quizzes","Other Features"],titleterms:{"case":6,"new":5,about:0,adding:[],author:0,contact:0,content:[],cours:5,creat:7,dashboard:4,design:7,document:1,edite:7,featur:[3,5,6,8],grade:8,histori:0,how:6,indice:[],install:2,installat:2,introduct:3,licens:0,moder:4,monitor:8,other:8,paper:[7,8],question:[6,7],questionpap:[],quick:2,quiz:7,quizz:7,set:[5,6],start:2,tabl:[],test:6,trial:8,user:8,welcom:1,write:6,yaksh:[0,1,2]}})
\ No newline at end of file diff --git a/yaksh/documentation/images/add_question.jpg b/yaksh/documentation/images/add_question.jpg Binary files differnew file mode 100644 index 0000000..a4b343e --- /dev/null +++ b/yaksh/documentation/images/add_question.jpg diff --git a/yaksh/documentation/images/questions.jpg b/yaksh/documentation/images/questions.jpg Binary files differnew file mode 100644 index 0000000..6bc4ea2 --- /dev/null +++ b/yaksh/documentation/images/questions.jpg diff --git a/yaksh/documentation/moderator_dashboard.rst b/yaksh/documentation/moderator_dashboard.rst index a4b2260..a93ea3c 100644 --- a/yaksh/documentation/moderator_dashboard.rst +++ b/yaksh/documentation/moderator_dashboard.rst @@ -13,4 +13,5 @@ The following pages explain the various functions available for moderators moderator_docs/creating_course.rst moderator_docs/creating_quiz.rst - moderator_docs/creating_question.rst
\ No newline at end of file + moderator_docs/creating_question.rst + moderator_docs/other_features.rst
\ No newline at end of file diff --git a/yaksh/documentation/moderator_docs/creating_question.rst b/yaksh/documentation/moderator_docs/creating_question.rst index 5e43b8d..421b3d6 100644 --- a/yaksh/documentation/moderator_docs/creating_question.rst +++ b/yaksh/documentation/moderator_docs/creating_question.rst @@ -2,5 +2,90 @@ 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. + + * **Active** - If the question is active to attempt or not. + + * **Type** - Type of the question. i.e Multiple Choice, Multiple Correct Choice, Code and Assignment Upload. + + * **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. + + * **Test case type** - Test cases or answers are to be added. There are multiple type of test cases - + + * Standard Test Case which is an assertion based testcase. + * Stdout Based Test Case is stdout based test where moderator can provide expected output (Only for Python). + * MCQ Based Test Case is testcase for Mcqs and Mccs. + +How to write Test cases +----------------------- + + The following explains different methods to write test cases. + + * **Create Standard Test Case** + + Select Standard Test Case and click on Save & Add Testcase button to save the question. + + * For Python: + In the test case field write a python assert to check the user code. + For e.g. :: + + assert fact(3) == 6 + + for program of factorial. + + * For C, C++ and Java: + In Test Case Field add the test case file path. + + Check Delete Field if a test case is to be removed. + + Finally click on Save & Add Testcase Button to save the test case. + + + * **Create Standard out Based Test Case** + + Select Stdout Based TestCase from Test Case Type field and click on Save & Add Testcase button to save the question. + + In Expected Output Field type the expected output for a particular question. For e.g type 6 if the output of the user code is 6. + + * **Create MCQ Based Test Case** + + Select MCQ Based TestCase from Test Case Type field and click on Save & Add Testcase button to save the question. + + In Options Field type the option check the correct checkbox if the current option is correct and click on Save & Add Testcase button to save each option. + + +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 json file of the Questions selected. + + * **Upload Questions** + + Click on the Upload File button. This will open up a window. Select the json file of questions and click Ok and the 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.
\ No newline at end of file diff --git a/yaksh/documentation/moderator_docs/creating_quiz.rst b/yaksh/documentation/moderator_docs/creating_quiz.rst index bf82e4d..de0f031 100644 --- a/yaksh/documentation/moderator_docs/creating_quiz.rst +++ b/yaksh/documentation/moderator_docs/creating_quiz.rst @@ -11,7 +11,7 @@ Creating a Quiz --------------- .. image:: ../images/add_quiz.jpg - .. note :: It is important to have created or uploaded questions before creating a quiz. Click here to know how to add questions. + .. note :: It is important to have created or uploaded questions before creating a quiz. In courses click on **Add Quiz** button to add a quiz. diff --git a/yaksh/documentation/moderator_docs/other_features.rst b/yaksh/documentation/moderator_docs/other_features.rst new file mode 100644 index 0000000..2e670ac --- /dev/null +++ b/yaksh/documentation/moderator_docs/other_features.rst @@ -0,0 +1,20 @@ +============== +Other Features +============== + +Grade User +---------- + + Grade User is a feature of Yaksh to access students' answer papers for each quiz and grade them where necessary. + +Monitor +------- + + Monitor is a feature of Yaksh where the moderator can monitor a quiz and view statistics. + +Trial Papers +------------ + + When a moderator attempts a quiz in User or God mode or tests questions, a trial answer paper is created. Moderator can check the answer paper. + + .. note:: It is advisable to delete these trial answer papers.
\ No newline at end of file |
