Track feedback

Decide when users are able to share feedback about the track.

Overview

Users can provide valuable feedback on Instruqt tracks by rating their experience on a scale from very unhappy to very happy.

Happiness rating scale

After rating it's also possible to add written feedback.

Written feedback

Track authors can configure feedback settings to best fit their needs. By default, the feedback option appears at the end of the track, after all challenges are completed.

Alternatively, authors can enable a persistent feedback tab, allowing users to share feedback during any challenge. For cases where feedback isn’t needed, this option can also be disabled entirely.

Persistent feedback tab

Feedback Score Behavior

Currently, Instruqt only stores a single feedback submission per play, meaning that each new score and comment will replace the previous one. The written feedback is tied to the score, so submitting a new score will reset any previously entered comments.

For example, if a user rates the track with a score of three during an early challenge, but updates it to a score of two later on, the final feedback recorded for the track will be a score of two.

Configure the track feedback

You can configure a track's feedback using the Instruqt web UI:

🌐 Web UI

1. Select the track you wish to configure.

2. In the Settings section, click Edit.

3. Click Additional settings.

4. In the Track feedback section, you will see two options:

   1. After user completes all challenge - Toggle this option on to enable feedback at the end of the track.

   2. During any challenge - Toggle this option on to enable a persistent feedback tab displayed during all challenges.

   It is also possible to disable both options to disable feedback for the track entirely.

5. Click Save.

track.yml

1. Open the track.yml of the desired track.

2. Under the lab_config section you can add or modify the following options: feedback_tab_enabled and feedback_recap_enabled.

3. Set feedback_tab_enabled to true if you want to enable a persistent feedback tab displayed during all challenges.

4. Set feedback_recap_enabled to true if you want to enable feedback at the end of the track.

Example of how a track.yml would look like with both options enabled.

slug: mytrack
id: baekpuxv2m5g
type: track
title: MyTrack
teaser: Get started quickly with just one container-based sandbox host.
description: Get started quickly with a container-based sandbox host. Choose a container
  when you need a fast, lightweight Linux system.
...
owner: myteam
developers:
- [e-mail]
...
lab_config:
...
  feedback_recap_enabled: true
  feedback_tab_enabled: true
 ...t