Integration approaches

There are several ways to use AlgebraKiT from your environment, each having its own advantages and disadvantages.

Granularity : exercises vs interactions

An 'exercise' can be a complex item consisting of instruction blocks, possibly containing images or other resources, and one or more questions. An 'interaction', on the other hand, is a single scorable element where a student enters input. You can use AlgebraKiT to handle a complete exercise for you, or you can keep the exercise in your own platform and let AlgebraKiT take care of only the truly mathematical interactions and resources.

As an example, consider the exercise in the image below. Exercise-resource-interaction You can create this exercise in AlgebraKiT and run it from your platform as a single element. However, most parts of this exercise are general content items: text, images, question numbers, etc., that might already be handled by your learning platform.

Therefore, we made it possible to insert only the math elements (math interactions and math resources) into your exercise. This approach has several advantages:

  • You can mix AlgebraKiT and non-AlgebraKIT interactions in the same exercise
  • AlgebraKiT does not interfere with how you store and manipulate your content.
  • You rely on AlgebraKiT only for the mathematical features it adds. You remain in full control of everything else.

A drawback of this approach is that it is a bit more complex to set up. For example, to calculate the score for an exercise, your platform needs to assemble the results from all AlgebraKiT and non-AlgebraKiT interactions and calculate the aggegated score. If you let AlgebraKiT handle the entire exerise, this would be handled for you.

This integration approach also works for randomized exercises. AlgebraKiT is aware that the interactions and resources belong to the same exercise, even though you are free to place them anywhere you like.

Integrate authoring tools

You have a choice to author the AlgebraKiT exercises (or interactions) from AlgebraKiT's Content Management System, or to integrate AlgebraKiT's authoring tools into your own authoring software.

The simplest and quickest way to use AlgebraKiT is to let your authors create and test the math interactions from the AlgebraKiT CMS. Each exercise receives a unique ID that you can use to refer to this exercise from your system. This way, the authoring process can start immediately, even before AlgebraKiT is integrated into your learning environment. The main disadvantage is that an author needs to work in two environments to build exercises: the AlgebraKiT CMS for the mathematical elements and your own authoring environment for everything else.

An alternative is to integrate AlgebraKiT's authoring tools into your authoring environment. These authoring tools are web-based components that can be injected into your system. Your system then becomes responsible for storing the AlgebraKiT specifications. This way, you limit the dependency on AlgebraKiT to an absolute minimum and your authors can do their work from a single environment.