# Tags and annotation syntax

This vignette documents supported teacher tags.

## Supported tags

- `skip`: keep chunk unchanged.
- `exercise-only`: generate only exercise block.
- `solution-only`: generate only solution block.
- `mcq`: force MCQ generation for the chunk.
- `narrative-only`: keep chunk as narrative context.
- `locked`: mark exercise as locked information text.
- `hints`: add hints before generated exercise.

## Example

    # tutorizeR: mcq, hints=Inspect the grouping variable|Summarise by program
    activity |>
      dplyr::group_by(program) |>
      dplyr::summarise(
        mean_hours = mean(study_hours),
        .groups = "drop"
      )