How should I format my questions in the TestGorilla platform?

At TestGorilla, we want to give candidates a consistent experience across different tests. The following formatting standards ensure that all tests are visually uniform. Please follow these guidelines.

Let's start with the basics. If your question is just one sentence, do not apply any special formatting.

Formatting questions (general)

 

However, if highlighting part of the question is helpful (to make things easier for candidates to understand), you should use bold text.

 

If your question requires a few lines of context first, separate the context and question with a line break (by hitting "enter"), then bolden the question itself.

 

Write questions as actual questions. Avoid using incomplete sentences ending on semicolumn (:) or ellipsis (...). For example, don't say "The core elements of UX design are:" Instead, ask the full question, as shown below.

Including instructions with your question

If your question contains instructions for the candidate, use italics.

Using quotes in questions

If you quote a text, make it stand out by using the quote feature:

Citing sources

If you need to cite a source, put it below the actual question. Separate it by hitting "enter" three times, then put it in italics.

Referring to images, keys, and menu items.

Questions and answers will often reference screenshots, keyboard keys, or menu items (especially on technical and software tests) to clarify their meaning. 

Referring to images and screenshots: If the question only includes one image, simply say "as shown in the image below" or something similar as appropriate. If the question and answers refer to any of multiple images, name the images and reference the appropriate name. If you're using a combination of image references and keyboard keys, see keyboard section below. 

Referring to keyboard keys and mouse actions: Capitalize keyboard keys, using both PC and Apple versions, and accompany them with the appropriate action. For example: Press Control (PC)/Command (Apple) + F. Mouse or trackpad actions don't need special formatting. For example: double-click the left key, etc. When combining keyboard actions with screenshot images, include the screenshot images in quotes. For example: Press Control + "C" (where "C" refers to image or point "C" offered in a screenshot). 

Refering to menu items: When referring to menu items in a software, use bold formatting and copy the capitalization used in the software. For example, Click File and select Save as... or click EditImage, etc. 

Placement of images and blocks of code

Write questions and/or any introductory text above an image or block of code (never below it) and add a line break (by hitting "enter") between the last line of text and the image, as shown below.

If a question requires candidates to review images or pieces of code in a specific order you can add the question at the end (but only where absolutely necessary). 

Screenshot 2020-07-03 10.17.35

Capitalization

Make sure to capitalize official names of methods, tools, features, etc.

Code formatting

Insert small snippets of code using the in-line code function, then bold the text.

 

Multiple lines of code go in a code block:

Introducing true/false questions

For true or false question types, always include "True or false:" (in bold) before the sentence the candidates must evaluate for clarity.

Screenshot 2020-07-03 10.06.20

Ordering answers in a specific order

By default, the answer options to multiple-choice questions appear in random order when presented to candidates. If there is a logical order to your answer options, make sure to uncheck the "Shuffle answers" box located in the bottom right of your answer module:

 

If the same answer options appear for multiple questions in your test, you should also uncheck the "Shuffle answers" box. This makes it easier for candidates to select their answers.

Introducing answers to multiple response questions

Important: For multiple-response questions, do not include "Select all that apply" (or anything similar) in your question description. This is already given by the software above the answers for every multiple-response question (as shown below).

Using periods (or not) at the end of answers

For answers that include any verb form, even if it's just a participle (like “driving home” or “taking the trash out”) use a period. When the answer uses only nouns and/or adjectives like (“home” or “at the shop” or “educational resources”), don’t use a period:

If there's a mix of answers that use verb forms and answers that don't, first check to see if you can rewrite all answers in the same format so that they all include or don't include a period. If that's not possible, use a period in all answers to that question for consistency.

If you have any questions about formatting or come across other cases we didn't cover in this guide, please contact us here.