Contents...

• Using the Quiz App
  • Managing Which Questions are Asked
• For Administrators
  • Tags
  • Manage Quiz
    • Title Bar Buttons
    • Quiz Details
    • Reference Transforms
    • View References
    • View Tags
  • Import and Export Questions in a CSV File

Using the Quiz App

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

Choose your answer by clicking an option button 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" 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".

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.

Tags

Administrators can create tags (or labels) and attach them to questions. A tag might be used to group a set of questions around a subject, to associate questions with an examination section, or to filter out basics for consumption by novices wishing to learn the game. A question can have any number of tags.

A new tag can be created in any of the places it might be used or referenced.

Tags can be attached to questions when viewing the questions in one of the review modes via the Add Tag button on the right. The tags already associated with a question are listed on the right and can be removed by clicking on the tag name.

Tags can be renamed, which does not affect their existing associations. They can be deleted, which also removes them from all the tagged questions.

If a large number of questions are to be tagged, it is more efficient to view all questions in the quiz and use the select box on the left and the bulk action button at the bottom.

Tags are listed in the Manage Quiz section, see below for details.

Manage Quiz

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

Title Bar Buttons

• Spell Check
  • Runs the built-in spell checker on all the questions in the quiz.
• 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 optional space, for example: 10.5.5(b), 10.6.1(c)
• View All
  • Shows all the questions and answers in a table with buttons to add options or update any of the 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.
• Check
  • Checks that every question has at least two options and exactly one is marked as the correct answer. It also checks all links vital to the proper operation of the system. Editors are advised to run this when they have added new questions or updated existing ones.
• Do Quiz
  • Exits the management menu and starts the quiz as a regular user would see it.

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

Quiz Details

Basic information about the quiz, including the introductory text - click "Update" to edit.

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:

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".

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.

View References

Shows a list of all the references used with a count of the questions that refer to them and a link to review those questions one by one.

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

Click the reference to be asked the related questions.

View Tags

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

Click the tag name to edit or delete it.

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

Click a question ID to edit that question.

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

Import and Export Questions

Depreciated - CSV coming soon