Question Creation

Learn how to create dynamic, engaging practice questions

Dynamic Questions

BlitzGrok's most powerful feature is dynamic question generation. Instead of creating individual static questions, you create question templates with variables that generate unique questions each time.

Why dynamic questions?

Students get unique practice each time
Prevents memorization, builds understanding
One template = infinite variations
Better assessment of true mastery

Question Types

Multiple Choice

Students select from predefined options. Use for:

Concept identification
True/False questions
Best answer scenarios

Answer format: Expressions that evaluate to 'True' or 'False'

UI Walkthrough (Screenshots)

Multiple choice question create form — Multiple choice create form

Multiple choice question created — Multiple choice created

General Questions

Students enter numeric or text answers. Use for:

Math calculations
Fill-in-the-blank
Short answer responses

Answer format: Python expressions that evaluate to the correct answer

Creating Questions

1 Define Variables

Variables make your questions dynamic. Each variable has:

Name - Used in prompts and answers (e.g., x, speed)
Expression - Python code that generates the value (e.g., randint(1, 10))

Example Variables:

x = randint(1, 10)
y = randint(1, 10)
answer = x + y

Available Functions: randint(a, b), choice([items]), uniform(a, b), round(x), and more

2 Add Constraints (Optional)

Constraints filter out invalid variable combinations. Use when:

You need specific relationships between variables
Certain combinations don't make sense
You want to control difficulty

Example Constraints:

x > 5 - Only generate when x is greater than 5
x != y - Ensure x and y are different
answer > 0 - Only positive answers

Careful: Overly restrictive constraints can slow question generation

3 Write Prompts

The question text shown to students. Use {variable_name} to insert values.

Example Prompt:

What is {x} + {y}?

With x=3, y=5, student sees: "What is 3 + 5?"

Tip: You can add multiple prompt variations for variety

4 Define Answers

Specify the correct answer(s) using Python expressions.

For General Questions:

answer - Use a variable you defined
x + y - Calculate directly
str(round(result, 2)) - Format the answer

For Multiple Choice:

'True' - This option is correct
'False' - This option is incorrect
str(x > 5) - Conditional correctness

Note: Answers are Python expressions evaluated in the variable context

Complete Example

Goal: Create a simple addition question

Variables

x = randint(1, 10)
y = randint(1, 10)
answer = x + y

Constraints

answer <= 15

Keep answers reasonable

Prompt

What is {x} + {y}?

Answer

answer

Best Practices

Test thoroughly - Generate multiple instances to ensure variety
Clear prompts - Be specific about what you're asking
Appropriate ranges - Don't make numbers too large or complex
Use constraints wisely - Filter impossible cases, but don't over-constrain
Add explanations - Help students learn from mistakes
Vary difficulty - Create multiple questions at different levels

Add Visual Content

Ready to enhance your questions with diagrams and visual content?

Learn About Diagram Integration