# Hints

There are four different types of hints within AlgebraKiT:

1. Context hints
2. Step hints
3. Reveal hints (algebra only)
4. Algebraic hints (algebra only)

The first two types are provided by you as an author, the last two types of hints are automatically generated by AlgebraKiT.

Below a short description of each hint type is given:

Context hints

Context hints are hints defined by authors given to the students before the AlgebraKiT hints are given. This is especially useful for context-rich exercises. For example, you might want to define a hint to rephrase the question, or to help the student to transform the question into a mathematical problem.

You can define multiple context hints if you want. These will be shown one at a time, when the student requests a hint. If no more context hints are available, AlgebraKiT will try to generate the next hint.

When you click Context hints you will get a text editor similar to the question text-editor where you can enter the hint information. You can also enter mathematical expressions by using the f(x) button.

For the algebra interaction specifically holds: the context hint is the first hint given before entering any valid algebraic input. Once a student has given input that is matched to one of the steps in the solution strategy, the context hints are no longer provided to the student when clicking on the Hint button. A step hint, reveal hint or algebraic hint is given instead.

0 / 0

Step hints

The description of a step defines ‘what’ this step means and is used by AlgebraKiT to generate the step hint.

Note: In case you have multiple steps defined in your interaction, make sure to give each step a description, also the solution step. Otherwise, step hints won’t work as expected.

0 / 0

Define the relation between steps. If steps relate to each other, make sure to use the step name in the task definition, or by using the precondition field of a step. By doing so, you help AlgebraKiT understand the solution strategies available and building a correct solution model.

0 / 0

Reveal hints

Reveal hints are currently only available for the algebra interaction.

Reveal hints are automatically generated hints by AlgebraKiT based on the expression that should be used by the student to get to the solution of the step the student is working on. It is called reveal hint, as it ‘reveals’ the algebraic expression from the step to solve to get to the solution.

The feature is added to the algebra interaction only, as this interaction type allows AlgebraKiT to understand the complete (algebraic) path for the student to the solution step. Therefore, AlgebraKiT is able to always give a reveal hint when the student starts with a new step.

In the example below, the third hint is called the reveal hint.

Try it yourself in the interactive version below.

Interactive student version:

Worked solution: