---
title: Assessments
framework: docc
role: symbol
role_heading: Directive
path: docc/assessments
---

# Assessments

Tests the reader’s knowledge at the end of a tutorial page.

## Declaration

```swift
@Assessments {
    @MultipleChoice { ... }
}
```

## Mentioned in

Building an Interactive Tutorial

## Overview

Overview Use the Assessment directive to display an assessments section that helps the reader check their knowledge of your Swift framework or package APIs at the end of a tutorial page. An assessment includes a set of multiple-choice questions that you create using the MultipleChoice directive. If the reader gets a question wrong, you can provide a hint that points them toward the correct answer so they can try again. @Tutorial(time: 30) {          ...

@Assessments {         @MultipleChoice {             What element did you use to add space around and between your views?

@Choice(isCorrect: false) {                 A state variable.

@Justification(reaction: "Try again!") {                     Remember, it's something you used to arrange views vertically.                 }             }

@Choice(isCorrect: true) {                 A `VStack` with trailing padding.

@Justification(reaction: "That's right!") {                     A `VStack` arranges views in a vertical line.                 }             }

@Choice(isCorrect: false) {                              ...                            }         }       } } Contained Elements An assessment contains the following items: Containing Elements The following items include assessments: Tutorial

## Topics

### Defining Questions

- [MultipleChoice](docc/multiplechoice.md)

## See Also

### Related Documentation

- [Tutorial](docc/tutorial.md)