# 2024-02-14

#### Release Date: 02/14/2024

## New Features

### Bricks Create

Two new vignette types have been added to the Bricks Create platform and are supported in the Brick Exchange platform when bricks are viewed. They are:

* Clinical Reasoning vignette type
* Matching question type

#### New Vignette Type - Clinical Reasoning

The clinical reasoning vignette type will be used in clinically oriented bricks to highlight parts of the clinical reasoning process which are important for the related brick text.

To add a Clinical Reasoning vignette to a brick, perform the following steps.

1. Open the desired brick or create a new brick.
2. Click the ‘**+**’ sign to add a new section, or, if you have the Bricks Create beta version enabled, type ‘**/clinicalreasoning’** and click the ‘**Enter**’ key. The Clinical Reasoning vignette is added to the brick.

<figure><img src="https://1583207202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVLYSduVGJDMCiOYAxBmQ%2Fuploads%2FWwYaO18EkrUd8gYHzRmr%2Fimage.png?alt=media&#x26;token=538391db-1bae-4c7c-9913-89bdd7798c88" alt=""><figcaption></figcaption></figure>

3. Enter text and/or type ‘**/bulletedlist**’ to add a bulleted list, or type ‘**/numberedlist**’ to add a numbered list.

#### New Question Type – Matching

Bricks Create now includes a new active learning question type called 'matching'. The example provided below, featuring terms and definitions, is just for illustration purposes. This format can be adapted for various educational objectives to evaluate student understanding. For instance, you could create a column labeled 'Etiology' and pair it with a second column titled 'Early Clues to the Diagnosis' for matching.

To add a matching question type, perform the following steps.

1. Open the desired brick or create a new brick.
2. Click the ‘**+**’ sign to add a new section, or, if you have the Bricks Create beta version enabled, type ‘**/question**’ and a new question is displayed.
3. Click the ‘**Matching**’ question type.

<figure><img src="https://1583207202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVLYSduVGJDMCiOYAxBmQ%2Fuploads%2FQccErKHt3drdRvj9fnA9%2Fimage.png?alt=media&#x26;token=84221cd9-a31a-4519-a002-68e2bb836e19" alt=""><figcaption></figcaption></figure>

The following table describes the items on this active learning matching question type modal.

| Item                                                                                                                                                                                                                                                       | Description                                                                                                                                                 |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Question field                                                                                                                                                                                                                                             | Enter question text.                                                                                                                                        |
| Term field                                                                                                                                                                                                                                                 | Enter a term. There is no max-character limit on this field; however, it is a best practice to keep a term as concise as possible.                          |
| Definition field                                                                                                                                                                                                                                           | Enter a definition for the term. There is no max-character limit on this field; however, it is a best practice to keep a definition as concise as possible. |
| <img src="https://1583207202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVLYSduVGJDMCiOYAxBmQ%2Fuploads%2FrUUZFcO50iTu7nQ9JuKG%2Fimage.png?alt=media&#x26;token=a66583ba-8b83-4cb3-b513-603f53d56521" alt="" data-size="original"> | Reorder button. You can reorder the term with its matching definition by clicking on the two lines and dragging the term into a new position.               |
| <img src="https://1583207202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVLYSduVGJDMCiOYAxBmQ%2Fuploads%2FguDakWmnbj0JpyldLYj6%2Fimage.png?alt=media&#x26;token=126c8a39-179e-42af-bd15-8c80675697b5" alt="" data-size="original"> | Add. Click the ‘+’ button to add a new term & definition combination.                                                                                       |
| <img src="https://1583207202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVLYSduVGJDMCiOYAxBmQ%2Fuploads%2FRsoreWBXglDeY7wNRIm9%2Fimage.png?alt=media&#x26;token=c02dd8be-0ac8-4d6a-a1b4-f0cba7c52fe2" alt="" data-size="original"> | Delete. Click the ‘-‘ button to remove the last row. When there is only one row left, click the trash can icon to delete the vignette entirely.             |
| Explanation                                                                                                                                                                                                                                                | Enter a general explanation that will help the reader understand the matching question content.                                                             |

**\[Author view - example of a completed ‘matching’ active learning question type]**

<figure><img src="https://1583207202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVLYSduVGJDMCiOYAxBmQ%2Fuploads%2FgkHuavngrgtdyPKoAFdF%2Fimage.png?alt=media&#x26;token=327e5f27-509b-4130-b5c3-02412cb73082" alt=""><figcaption></figcaption></figure>

#### Viewing a Matching Active Learning Question

When viewing a brick on the Brick Exchange, a ‘matching’ active learning question type displays and functions as follows:

<figure><img src="https://1583207202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVLYSduVGJDMCiOYAxBmQ%2Fuploads%2FvaxyaKP3dOT9oggVGfLH%2Fimage.png?alt=media&#x26;token=9710fc6d-2ec1-4ee0-9ced-a6f293ddd49c" alt=""><figcaption></figcaption></figure>

* Drag and drop a definition to the corresponding term. Each term can only have one definition.
* When the definition is matched with the correct term, a green check mark is displayed.
* When the definition is matched with an incorrect term, a red ‘X’ is displayed.
* When all terms are correctly matched, the explanation is displayed.

<mark style="color:orange;">Note: Brick question answers are retained unless the content of the answers change when the brick is versioned.</mark>
