Skip to content

Editor: A Tool for Exercise Creation

In a nutshell:

  • The Editor is a user-friendly interface for designing INJECT exercises.
  • It makes exercise creation accessible without requiring YAML expertise, because it guides designers through a structured creation process.
  • The Editor supports the latest definition version, which can be directly used in the platform.
  • Definitions created outside of the Editor can also be imported for further editing and visualization.

Where are we in the INJECT process?

What is the Editor?

The Editor is a new component of the INJECT Exercise Platform that innovates how exercises are created. While exercises have traditionally been defined manually in YAML format (requiring technical expertise), the Editor provides an intuitive interface that guides you through the exercise creation process.

Key Benefits

  • User-Friendly Interface: No YAML knowledge required
  • Guided Process: Step-by-step exercise creation
  • Structured Approach: Systematic organization of exercise components
  • Automated Generation: Produces valid YAML exercise definitions automatically

Should You Use the Editor?

Yes! If you are not familiar with YAML or prefer a guided approach, the Editor is an excellent choice. Even if you are experienced with the definition format, the Editor can speed up the design process and help visualize complex exercises.

How to start?

  • The Editor is easily accessible through the INJECT Gateway – see the picture below.
  • Once you start using it, it will guide you through a structured process.

Editor interface in INJECT Gateway

Limitations

While the Editor is a powerful tool, it currently has some limitations compared to manual YAML editing, that you should be aware of:

Single Exercise Definition Focus

  • You can only work with one exercise definition at a time
  • Saving and loading different exercise definitions requires manual file management

Local Storage

  • Definitions are stored locally in your browser using IndexedDB
    • This means your work is not synced across devices or browsers
    • Make sure to back up your work regularly
  • The Editor storage is shared between all users on the same device/browser

Role Management

  • The Editor has no direct support for role-based exercises
  • Roles need to be added manually after export

INJECT Process Overview