Using the Quiz

Home

Games

Golf

Rules

Rules Quiz

Help

Contents...

Using the Quiz App

Questions are asked at random from the pool of unanswered questions.

Choose your answer from the options by clicking the button next to your choice and then "Check My Answer".

After submitting your answer, you'll see:

Whether your answer is correct
A link to the relevant Rules, Laws, Tournament Regulations, or Refereeing Regulations, which opens in a new window and scrolls to the referenced section
An explanation of how the Law/Rule applies to the question
Your rolling score (indicating your progress and performance)
A "Next Question" button

Managing Which Questions are Asked

Each question is asked only once. The list of questions you've answered and your score are stored in a cookie on your machine. To reset the memory, click "Forget which questions I've already answered and my score" on the quiz's home page (to get there, click the Home button in the title bar).

If you are studying the Laws or Rules, you can focus attention on one or more Rules or Laws via the quiz's home page "Restrict Which Questions are Asked" section by filling in the box "Ask only about Rule/Law". You can be very specific (e.g. 20) or general and use a comma-separated list, e.g. 15, 17.2.3, 18, 19

If the administrator has created tags for the questions, for example, "Basic Play", you can select the tagged questions by choosing a tag in the "Restrict Which Questions are Asked" section on the quiz's home page.

If you wish to email a link to draw attention to a particular question, for example, to point out an error or ask a detailed question, use the link "Link to this question" at the foot of the answer page - right-click and select "copy link address".

Taking an Exam

On the quiz home page, select the exam you want to take. You'll see an introduction page, and you should confirm that you have understood what happens when you start the exam.

If there is a time limit, and that time elapses from when you look at the first question, the exam ends.

If you reach the end of the exam by answering sufficient questions within any time limit, your score is recorded, and a summary page displays your score and outlines the next steps.

On the home page, the Exam Results button reveals all your completed exam attempts and the mark reached for each. Click to see your achievement certificate for any that you passed. For administrators, all candidates are listed.

To abandon an exam, click the button "Abandon the exam in progress" on the quiz's home page. During an exam, you may navigate away, but when returning to the quiz, you must either continue the exam or abandon it.

For Administrators

Members of the group Quiz Masters have full administrator rights over the quiz and this help page (available only after clicking Enable Privileges).

Questions and all setup can be edited online or in bulk by clicking the Manage Quiz title-bar menu option. There's also an option to export a CSV file for offline editing and subsequent upload.

Manage Quiz

The Manage Quiz page contains all the information and options to configure the quiz.

Title Bar Buttons

Home
- Exits the management menu and starts the quiz as a regular user would see it.
Add Question
- Adds a new question with options and references. Press save when you are done (otherwise, nothing happens).
- Note that the reference to the relevant Law/Rule/Regulation:
  - Should be the full reference number exactly as it appears in the referenced document.
  - Multiple references should be separated with a comma and an optional space, for example: 10.5.5(b), 10.6.1(c)
  - See the Reference Transform section for the exact formats supported.
Spell Check
- Runs the built-in spell checker on all the questions in the quiz.
Check
- Checks that every question has at least two options and exactly one is marked as the correct answer. It also verifies all links essential to the system's proper operation. Editors are advised to run this when they have added new questions or updated existing ones. It is automatically run when an attempt is made to change an exam's status to live.
CSV Import/Export
- Download selected questions in a CSV file.
- Upload a CSV file to update or create questions, or to modify question tagging.

The remainder of the page features twistie sections, which reveal their secrets when clicked.

Quiz Details

Basic information about the quiz, including the introductory text, is displayed - click "Update" to edit. Note that there are two fields for introductions:

If only the first is filled, it applies to the overall quiz app and is displayed on the home page, whether an exam is in progress or not
If both are filled:
- The first is used as an introduction to the quiz and is not displayed when an exam is in progress
- The second is used as an introduction to the exams section

A count of the questions in the quiz follows, with options to:

View All
- Displays all questions and answers in a table, along with buttons to add options or update any details.
View in Turn
- Scrolls through the questions in numerical order, rather than at random, to facilitate checking. This is also available to review the questions relating to a reference and/or a tag.

View References

Shows a list of all the references used by all the questions in the quiz, with a count of the questions that refer to them and a link to review those questions one by one. Where a multi-part number is used (e.g. 4.2), the number is broken down into its parts (so 4.2 appears as 4 and 4.2).

Use this table to target the generation of new questions to improve the spread and coverage.

View Tags (and Exams)

Lists the tags defined within the quiz and the questions assigned that tag.

A tag and exam are the same thing. An exam has more properties and associated functionality.

Click the tag name to edit or delete it.

Click "View in Turn" to review each of the tagged questions in turn (with edit buttons).

Click "View All" for a table of all the tagged questions (with edit buttons) and a title button to "Get as CSV".

Create a new tag with the button at the bottom of the section.

To convert a tag into an exam, edit it and click "Convert To Exam".

The exam tag's additional properties are displayed below the tag's basic details.

To Configure an Exam

Create a tag for the exam.
- Give the tag a name (e.g. "Referee Qualification Exam").
- Users see exam tags listed separately from general tags.
- Save and re-edit the tag and convert it to an exam
- Configure the exam's:
  - Number of questions to be drawn from the tag pool.
  - Pass mark.
  - Time limit, if required.
  - Introduction: displayed to candidates before starting the quiz.
  - Appendix: displayed to candidates on completing the quiz.
  - If there are too few tagged questions to meet the exam's requirements, you'll see a warning.
Prepare Questions
- If not already in the system, add questions to the quiz.
- Tag each question with your exam tag:
  - Online method:
    - View all the questions in the quiz.
    - Tick the questions you want to include in the exam.
    - Select Bulk Actions and apply the tag.
  - Offline method:
    - Upload a CSV file containing the tagged questions.
Make the exam live
- Change the exam's status to Live so candidates can access it.

Multi-Part Exams

An exam can have more than one part (or paper) with an overall pass mark for the combined sections of the exam.
The Master Exam:
- Has no questions of its own (the tag is not used to choose exam questions).
- Specifies the overall pass mark - the total correct answers for all sections.
- Issues the pass/fail certificate.
- Includes the overall introduction to the multi-part exam.
- Includes the appendix to be displayed at the end of the exam.
- Defines the first section as a follow-on exam.
Follow-on Exams:
- Define the number of questions to be asked in that section.
- Have no separate pass mark (must be zero).
- Optionally have introduction and/or appendix text displayed at the start/end of the section (usually blank).
- The final section has no follow-on exam and so returns control to the master to announce the overall result.
- Referencing an exam as a follow-on makes it a sub-section and removes it from the stand-alone exams that a user can select.
- Sub-sections' status is not used, only the master exam.

Configuring a Multi-Part Exam

Create the exam parts as above.
Create a new exam tag to be the Master Exam.
Edit the master exam and set the first section as its follow-on exam.
Edit each exam section in turn and set its follow-on section.
The final section has no follow-on exam.
Be careful to avoid a loop: do not use the same exam more than once as a follow-on exam.

Reference Transforms

Questions usually include one or more references to relevant Laws/Rules/Regulations in a comma-separated list; the transforms automatically convert them into active links.

The table shows the currently configured reference transforms:

Reference Transforms Current Implementation
GC Rules
Definition	Refers To	Examples
R<num>	Refereeing Regulations	R1, R4.2
TR-<any>	Tournament Regulations	TR-M2, TR-P2
<num><any>	GC Rules	5, 2.5.1, 3.1.3(b)
AC Laws
Definition	Refers To	Examples
R<num>	Refereeing Regulations	R1, R3
TR-<any>	Tournament Regulations	TR-P1, TR-M1
<num><any>	AC Laws	29, 32.1.1

When displaying the references (usually on the answer page), the references list is split into separate references. So, for example, a GC Rules question could reference "R2, 3.2.2, TR-5, 4".

Reference Transforms: Getting Technical

Only standard Regular Expressions (RegExp) are used at present:

The transforms are applied to each reference in turn in order of their sequence number.
If the Match RegExp matches the Reference:
- Transform P1 is used as the search RegExp and P2 as the Replace parameter to create the view string.
- P3 and P4 are used similarly to create the URL linking to the Reference.

Updating these is best left to people with significant experience of Regular Expressions.

Import and Export Questions in a CSV File

Follow the link for an explanation of what a CSV_Document CSV file is and how to use and create one.

In the Manage Quiz section, a CSV option in the title bar allows selection of upload or download CSV.

Selected questions can be downloaded, updated offline in a spreadsheet app and then uploaded to update the online version.

New questions can be added via CSV upload. Caution: Once uploaded, questions are assigned a number that must be used for future updates - re-uploading an updated CSV of questions will not modify them, it will create duplicates.

Export CSV (download):
- The set of questions exported can be restricted to those with a specified tag or those in a specified exam
- One question per line
- First column = database question ID
- The correct answer is the first option
- Includes tags (comma-separated list)
Import CSV (upload):
- Column headings must be on the first line, matching the download file:
  - QID
  - Question
  - Explanation
  - Refs
  - Tags
  - Options
    - Note that the options use as many columns as is necessary - a heading is above the first option only
- Subsequent lines in the CSV have one question per line, as follows:
  - QID: question database ID
    - Blank or 0 = new question - each gets assigned a database ID.
      - If you need to change new questions - don't re-upload them, instead:
        
        Download a CSV which contains the new questions with their assigned IDs
        
        Edit that CSV
        
        Re-upload it - the system will update based on the IDs rather than create duplicates
    - If the question number does not match a question in the database, an error is raised
    - Otherwise, the CSV line completely replaces the question, options and tags
      - If the question field is blank, the question is deleted from the database
      - Questions are not deleted from the database if their ID is missing from the CSV
  - Question text, which cannot be blank except to delete an existing question (other columns must conform)
  - Explanation text, which cannot be blank
  - Refs: Comma-separated list of references (warning issued if blank)
  - Tags: Comma-separated list of tags to apply to each question (can be blank)
    - Tags are created if not known (tags can contain spaces, but can't contain the comma as it is the list separator)
    - Tags not used in the CSV are not deleted
  - Options: The First option is the correct answer
    - Other options on the same row, one per cell
    - The options in the CSV replace all options for the question
    - There must be at least two options
    - Note that when the questions are asked, the options are presented in random order

If you upload a large number of questions, you would be wise to tag them all in the CSV so you can manage them as a set. The tag can be easily removed later, but it is difficult to identify your new questions otherwise.