Updated instructions for the test

docker-compose.yml

@@ -17,7 +17,6 @@ services:
       - ./ref-test/app/editor/static:/usr/share/nginx/html/editor/static:ro
       - ./ref-test/app/quiz/static:/usr/share/nginx/html/quiz/static:ro
       - ./ref-test/app/view/static:/usr/share/nginx/html/view/static:ro
-      - ./ref-test/app/analysis/static:/usr/share/nginx/html/analysis/static:ro
     ports:
       - 80:80
       - 443:443

nginx/conf.d/ref-test-app.conf

@@ -45,11 +45,6 @@ server {
         alias /usr/share/nginx/html/view/static/;
     }
 
-    location ^~ /admin/analysis/static/  {
-        include  /etc/nginx/mime.types;
-        alias /usr/share/nginx/html/analysis/static/;
-    }
-
     # Proxy to the main app for all other requests
     location / {
         include /etc/nginx/conf.d/proxy_headers.conf;

ref-test/app/analysis/templates/analysis/analysis.html

@@ -8,73 +8,44 @@
 {% endblock %}
 
 {% block content %}
-    <h1>Analysis by {{ type[0]|upper }}{{ type[1:] }}</h1>
+    <h1>Analysis</h1>
     <div class="container">
         <p class="lead">
-            The analysis section displays statistics for all test results as well as answers to individual questions.
+            Analysis for {{ type }} {{ subject }}.
-            Analysis reports can be generated per exam or per question dataset to identify common mistakes or patterns in answers.
         </p>
-        <div class="input-group mb-3">
-            <span class="input-group-text">
-                {% if type == 'exam' %}
-                    Exam Code
-                {% elif type == 'dataset' %}
-                    Dataset Name
-                {% endif %}
-            </span>
-            <span class="form-control">
-                {{ subject }}
-            </span>
     </div>
-        <div class="input-group mb-3">
+    <div class="container">
-            <span class="input-group-text">Total Entries</span>
+        <h3>
-            <span class="form-control">
+            Question List
-                {{ analysis.entries }}
+        </h3>
-            </span>
+        <div class="container dataset-metadata">
-        </div>
-        <div class="input-group mb-3">
-            <span class="input-group-text">Passed</span>
-            <span class="form-control">
-                {{ analysis.grades.merit + analysis.grades.pass }} ({{ ((analysis.grades.merit + analysis.grades.pass)*100/analysis.entries)|round(2) }} &percnt;)
-            </span>
-        </div>
-        <div class="mb-3">
-            <span class="badge rounded-pill progress-bar-striped bg-success">Merit: {{ analysis.grades.merit }}</span> <span class="badge rounded-pill bg-primary progress-bar-striped">Pass: {{ analysis.grades.pass }}</span> <span class="badge rounded-pill progress-bar-striped bg-danger">Fail: {{ analysis.grades.fail }}</span>
-            <div class="my-1 progress">
-                <div class="progress-bar progress-bar-striped bg-success" role="progressbar" style="width: {{ (analysis.grades.merit*100/analysis.entries)|round(2) }}%" aria-valuenow="{{ analysis.grades.merit }}" aria-valuemin="0" aria-valuemax="{{ analysis.entries }}">{{ (analysis.grades.merit*100/analysis.entries)|round(2) }} &percnt;</div>
-                <div class="progress-bar progress-bar-striped" role="progressbar" style="width: {{ (analysis.grades.pass*100/analysis.entries)|round(2) }}%" aria-valuenow="{{ analysis.grades.pass }}" aria-valuemin="0" aria-valuemax="{{ analysis.entries }}">{{ (analysis.grades.pass*100/analysis.entries)|round(2) }} &percnt;</div>
-                <div class="progress-bar progress-bar-striped bg-danger" role="progressbar" style="width: {{ (analysis.grades.fail*100/analysis.entries)|round(2) }}%" aria-valuenow="{{ analysis.grades.fail }}" aria-valuemin="0" aria-valuemax="{{ analysis.entries }}">{{ (analysis.grades.fail*100/analysis.entries)|round(2) }} &percnt;</div>
-            </div>
-        </div>
-        <div class="input-group mb-3">
-            <span class="input-group-text">Mean Score</span>
-            <span class="form-control">
-                {{ analysis.scores.mean|round(2) }} &percnt;
-            </span>
-        </div>
-        <div class="input-group mb-3">
-            <span class="input-group-text">Standard Deviation</span>
-            <span class="form-control">
-                {% if analysis.scores.stdev %}
-                    {{ analysis.scores.stdev|round(2) }}
-                {% else %}
-                    {{ None }}
-                {% endif %}
-            </span>
-        </div>
-        <div class="input-group mb-3">
-            <span class="input-group-text">Median Score</span>
-            <span class="form-control">
-                {{ analysis.scores.median|round(2) }} &percnt;
-            </span>
-        </div>
-        {% if type == 'exam' %}
             <div class="input-group mb-3">
                 <span class="input-group-text">Dataset Name</span>
                 <span class="form-control">
                     {{ dataset.get_name() }}
                 </span>
             </div>
+            <div class="input-group mb-3">
+                <span class="input-group-text">Author</span>
+                <span class="form-control">
+                    {{ dataset.creator.get_username() }}
+                </span>
+            </div>
+            <div class="input-group mb-3">
+                <span class="input-group-text">Last Updated</span>
+                <span class="form-control">
+                    {{ dataset.date.strftime('%d %b %Y %H:%M') }}
+                </span>
+            </div>
+            {% if dataset.default %}
+                <div class="input-group mb-3">
+                    <span class="input-group-text">
+                        <input type="checkbox" aria-label="Default" class="dataset-default" checked disabled>
+                    </span>
+                    <span class="form-control">
+                        Default Dataset
+                    </select>
+                </div>
             {% endif %}
         </div>
         <div class="container">
@@ -136,6 +107,7 @@
                 </tbody>
             </table>
         </div>
+    </div>
 {% endblock %}
 
 {% block script %}

ref-test/app/quiz/templates/quiz/instructions.html

@@ -3,13 +3,36 @@
 {% block content %}
     <div class="instruction-container">
         <h3>Instructions</h3>
+        <p>
+            Thank you for putting yourself forward to sit the SKA Referee Theory Exam. Please read the following instructions carefully.
+        </p>
+        <h4>
+            Taking the Exam
+        </h4>
         <ul>
             <li>
-                The exam comprises 100 multiple-choice questions.
+                The exam consists of 100 questions, all of them multiple choice with two or three options, which are designed to test your knowledge of a wide range of rules. For each question, answer what decision you would give as a referee unless the question instructs otherwise.
             </li>
             <li>
-                For each question, answer what decision you would give as a referee unless the question instructs otherwise.
+                It should take around an hour to complete.
             </li>
+            <li>
+                The exam should be taken under exam conditions. Materials such as the official rules, guidelines, revision resources, or similar should not be consulted during the test.
+            </li>
+            <li>
+                We would remind candidates that whilst we are relying on your honesty in this test, your theory knowledge will make up a part of the practical assessment when you are observed refereeing a game.
+            </li>
+            <li>
+                You also may not discuss the test with any other person while you are sitting it. 
+            </li>
+            <li>
+                If you have any queries before the exam or would like further feedback on the test, your emails are welcome.
+            </li>
+        </ul>
+        <h4>
+            Using the Web App
+        </h4>
+        <ul>
             <li>
                 You will be able to customise the display settings of the exam from the settings panel by clicking on the red gear button <a class="btn btn-danger" aria-title="Settings" title="Settings" onclick="return false;"><i class="bi bi-gear-fill"></i></a>.
             </li>
@@ -17,7 +40,7 @@
                 You can view your progress at a glance, as well as navigate to any question in the quiz, using the question grid, accessed via the yellow grid button <a class="btn btn-warning" aria-title="Question Grid" title="Question Grid" onclick="return false;"><i class="bi bi-table"></i></a>.
             </li>
             <li>
-                If you are unsure of the answer to a question or would like to revise a question, you can flag the question to review it later on using the flag button button <a class="btn btn-secondary" id="q-nav-flag" title="Flag Button." onclick="return false;"><i class="bi bi-flag-fill"></i></a>.
+                If you are unsure of the answer to a question or would like to return to a question later, you can flag the question using the flag button button <a class="btn btn-secondary" id="q-nav-flag" title="Flag Button." onclick="return false;"><i class="bi bi-flag-fill"></i></a> to serve as a reminder for you to come back to it later.
             </li>
         </ul>
     </div>
@@ -46,7 +69,7 @@
             Results
         </h4>
         <p>
-            The results of your exam will be processed immediately and sent to the SKA Refereeing Coordinator. You will also be emailed a copy of your results.
+            The results of your exam will be processed immediately and sent to the SKA Refereeing Coordinator. You will also be emailed a copy of your results. If you do not receive an email, make sure to check your spam folder.
         </p>
         <p>
             When you are ready to begin the quiz, click the following button.