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.

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.