# 2023-11-15

***

#### Release Date: 11/15/2023

## New Features: Bricks Create

Bricks Create now provides a method for customers to preview features that are in beta. The following section describes the beta features and how to toggle the beta preview on/off.

### Toggle Beta Features On/Off

To toggle the beta features on/off, perform the following steps.

* From Bricks Create, click the profile icon to display the menu options.

<div align="left"><figure><img src="https://1583207202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVLYSduVGJDMCiOYAxBmQ%2Fuploads%2Fc6Ga2o7MmlRap5D7s3LY%2Fprofile_beta.png?alt=media&#x26;token=a39c9356-88dc-49f5-9b65-41c8c024c4d3" alt="" width="205"><figcaption></figcaption></figure></div>

* Toggle the ‘**Beta Features**’ option on or off.

{% hint style="info" %}
***Note:** An application update is required when beta features are toggled on or off.*
{% endhint %}

### Beta Feature #1 - Create Brick Options <a href="#beta-option-1-create-brick-options" id="beta-option-1-create-brick-options"></a>

When the beta feature is toggled on, additional options display when the ‘**Create Brick’** button is clicked.

<div align="left"><figure><img src="https://1583207202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVLYSduVGJDMCiOYAxBmQ%2Fuploads%2FRWM57rjXsjGYQES2HRIh%2Fcreate-brick.png?alt=media&#x26;token=42b260ca-b1ce-4708-8018-7a0e2369d873" alt="" width="142"><figcaption></figcaption></figure></div>

### Blank Canvas

When selecting the ‘Blank Canvas’ option, you may create your brick from a blank brick template.

To create your brick from a blank canvas, perform the following steps.

* Click the **Create Brick** button and select the **Blank Canvas** option. A ‘Create Brick’ modal displays so you may select your desired brick language.
* Select the brick language and click the **Create Brick** button. A blank brick template is displayed.

![](https://1583207202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVLYSduVGJDMCiOYAxBmQ%2Fuploads%2FvjseCCHF3vWOCI6bccDK%2Fcanvas.png?alt=media\&token=b788bd19-b621-4ba8-9a82-82f672481edc)

* Complete the brick template & publish the brick.

{% hint style="info" %}
***Note:** All required elements (i.e., Title, Learning Objectives, Summary points, and Review Questions) must be completed before the brick can be published.*
{% endhint %}

### Begin with FIle

When selecting the ‘Begin with File’ option, you may create your brick from an existing .docx or .txt file. If you’re working in Google Docs or a PDF, you can save them as a .docx file to use with Bricks Create.

To create your brick by beginning with a file, perform the following steps.

* Click the **Create Brick** button and select the **Begin with File** option—the ‘Brick Converter’ modal displays.

<div align="left"><figure><img src="https://1583207202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVLYSduVGJDMCiOYAxBmQ%2Fuploads%2FR2y0QdXNCSxJUmN6D2kr%2Fbrick-converter.png?alt=media&#x26;token=9c8c81c1-65a0-4304-a3c7-83b0f9d10ac7" alt="" width="210"><figcaption></figcaption></figure></div>

* Click the **File Explorer** button to browse and select the desired file. The ‘File Processed’ section displays the name of the selected file.
* Click the **Create Brick** button. The file is turned into a brick. While we strive to convert the brick into the perfect format, the brick should be reviewed and formatted, as needed, before publishing.

The following brick vignettes will automatically be created:

* Headers
* Paragraphs
* Lists
* Images
* Tables

Customers will need to add or format any other vignette types, including:

* Videos
* Image carousels
* Equations
* Active learning questions
* Flashcards
* Learning Objectives (minimum of one)
* Summary points (minimum of one)
* Review Questions (minimum of one)

### Beta Feature #2 – Updated Authoring Design <a href="#beta-feature-2-updated-authoring-design" id="beta-feature-2-updated-authoring-design"></a>

The authoring experience in Bricks Create has been updated to be more streamlined. The following section describes the design updates outlined in the following screenshot.

<div align="left"><figure><img src="https://1583207202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVLYSduVGJDMCiOYAxBmQ%2Fuploads%2FSptyREliujKKhemGdg27%2Fauthoring-design.png?alt=media&#x26;token=f1cfcc2d-2945-4d80-baa9-ef46430eb57b" alt="" width="479"><figcaption></figcaption></figure></div>

#### Back button <a href="#back-button" id="back-button"></a>

The ‘back’ button provides a method to return to the ‘My Bricks’ page quickly.

#### Share & Publish <a href="#share-publish" id="share-publish"></a>

The Share & Publish buttons are now prominently displayed on the top right of the page.

* **Publish**. The ‘Publish’ button is only enabled when the brick is in a draft state. Once the brick is published, the ‘Publish’ button is disabled.
* **Share**. When clicked, the ‘Share’ button displays the following options.

| Item                | Description                                                                                                                                                                                |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Copy Draft Link     | The ‘Copy Draft Link’ provides a method to copy the URL to the draft brick so it can be shared.                                                                                            |
| Copy Published Link | The ‘Copy Published Link’ provides a method to copy the URL to the published version of the brick so it can be shared. This option is only enabled once the brick is in a published state. |
| Share Brick via…    | The ‘Share Brick via…’ option provides a method to share the brick via an external method. This option is only enabled once the brick is in a published state.                             |

### Version History <a href="#version-history" id="version-history"></a>

When clicked, the ‘Version History’ button provides a method to view the brick version history. A new version record is displayed on this page each time a brick is modified.

<div align="left"><figure><img src="https://1583207202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVLYSduVGJDMCiOYAxBmQ%2Fuploads%2FyeFnlGXRs83zhirBUBit%2Fversion-history.png?alt=media&#x26;token=c980d025-ab14-4845-a16a-8bf1f064cd44" alt=""><figcaption></figcaption></figure></div>

### Brick Info

When the ‘Information’ icon clicks, information related to the brick is displayed.

![](https://1583207202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVLYSduVGJDMCiOYAxBmQ%2Fuploads%2FuSJ63B7XyqLVQJdYlDUe%2Fbrick-info.png?alt=media\&token=b10edbe0-7ab2-4b08-8452-26fa48a97239)

### Settings

The brick ‘Settings’ option is now displayed on the bottom right of the page. As you scroll through the brick, the ‘Settings’ button remains in view. This is called a “sticky footer”. The settings page details are displayed on the same page but in separate screenshots below, making each option easier to see.

<div align="left"><figure><img src="https://1583207202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVLYSduVGJDMCiOYAxBmQ%2Fuploads%2F4MuDZqOJW3Ybl4BismcV%2Fbrick-settings.png?alt=media&#x26;token=140fb187-0a11-47a7-9751-03a34e9e695c" alt="" width="317"><figcaption></figcaption></figure></div>

<div align="left"><figure><img src="https://1583207202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVLYSduVGJDMCiOYAxBmQ%2Fuploads%2FE7OHiqhy8XPFOoatpSzX%2Fbrick-language.png?alt=media&#x26;token=ef207ccd-4fc7-4215-9a70-c182b976d086" alt="" width="563"><figcaption></figcaption></figure></div>

<div align="left"><figure><img src="https://1583207202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVLYSduVGJDMCiOYAxBmQ%2Fuploads%2FS5YgKbBItrXyzjtUofA8%2Fbrick-sharing.png?alt=media&#x26;token=42352c61-ab3c-4614-a7a0-03fd54052fb6" alt="" width="563"><figcaption></figcaption></figure></div>

The following table describes each section on the ‘Settings’ page.

| Item           | Description                                                                                                                                                                                                                                                                                           |
| -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Privacy        | <p><strong>Listed</strong>. When enabled, listed bricks appear on the school & author pages and will be returned in search results.</p><p><strong>Unlisted</strong>. When enabled, unlisted bricks will not appear on the school or author pages and will not be returned in search results.</p>      |
| Featured Image | This option provides a method for the brick to display an image.                                                                                                                                                                                                                                      |
| Language       | The brick language section determines the language in which the brick is displayed within Bricks Create and the Brick Exchange. This setting will not impact the logged-in user’s selected application language or other application content.                                                         |
| Sharing        | <p><strong>Published Link</strong>. The published link will only be activated when the brick is in a published state.  </p><p><strong>Draft Link</strong>. The draft link will always redirect to the most recent draft version of the brick.</p>                                                     |
| Administration | <p><strong>Transfer Ownership</strong>. Transferring ownership of a brick will remove you as the owner and allows the new owner to edit the brick’s content.</p><p><strong>Delete Brick</strong>. When the ‘Permanently Delete’ button is clicked, the brick is deleted and cannot be recovered. </p> |

### Beta Feature #3 - Updated Toolbox Design

The toolbox has been updated to a new dropdown list design.

\[**ORIGINAL TOOLBOX]**

<div align="left"><figure><img src="https://1583207202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVLYSduVGJDMCiOYAxBmQ%2Fuploads%2FVYIkBPgGZcrbRKhS4KKq%2Foriginal-toolbox.png?alt=media&#x26;token=f5c556ba-3cf9-48bf-a7f0-e9c271038d58" alt="" width="250"><figcaption><p>Original Toolbox</p></figcaption></figure></div>

**\[UPDATED TOOLBOX]**

<div align="left"><figure><img src="https://1583207202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVLYSduVGJDMCiOYAxBmQ%2Fuploads%2FSaklq9xJpafxQbwebNnA%2Fupdated-toolbox.png?alt=media&#x26;token=16f7961a-0bb9-442f-af4e-0aecaa41eae0" alt="" width="170"><figcaption><p>Updated Toolbox</p></figcaption></figure></div>

Click on the plus sign (+) or hit the ‘Enter’ button on your keyboard to access the toolbox when adding a new vignette (section) to a brick.

{% hint style="info" %}
***Note:*** When a vignette type that is only allowed to be used once in a brick is already used, it will still display in the list, but it will be disabled (i.e., Case Connection in the screenshot above).
{% endhint %}

### Beta Feature #4 – Power Functions <a href="#beta-feature-4-power-functions" id="beta-feature-4-power-functions"></a>

There are now power functions to aid power users during the brick authoring process. When adding new brick vignettes (sections), these power functions allow power users to keep their hands on the keyboard instead of using a mouse to click.&#x20;

To utilize these power functions, type a slash **‘/’** to display the power function menu, or type the power function as displayed below in the table.

<div align="left"><figure><img src="https://1583207202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVLYSduVGJDMCiOYAxBmQ%2Fuploads%2FygwwK7H8u6luTNI6ceC9%2Fpower-features.png?alt=media&#x26;token=1b5a335c-7469-4e6a-b4ec-be5b3cbb3da5" alt="" width="257"><figcaption></figcaption></figure></div>

The following table provides the vignette types, description, and the associated power function.

| Vignette Types       | Description                                                                                                                     | Power Function       |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------- | -------------------- |
| Text                 | Start authoring with plain text.                                                                                                | /text                |
| Header 1             | Add a primary section heading.                                                                                                  | /header1             |
| Header 2             | Add a secondary section heading.                                                                                                | /header2             |
| Bulleted List        | Organize items into a bulleted list.                                                                                            | /bulletedlist        |
| Numbered List        | Organize items into a sequentially numbered list.                                                                               | /numberedlist        |
| Table                | Add a table to display data in a tabular format.                                                                                | /table               |
| Equation             | Add an equation using LaTeX format.                                                                                             | /equation            |
| Image                | Insert a single image.                                                                                                          | /image               |
| Image Carousel       | Insert multiple images to create a sliding viewer.                                                                              | /imagecarousel       |
| Video                | Embed a video clip.                                                                                                             | /video               |
| Embed                | Embed a PowerPoint presentation or Google slides.                                                                               | /embed               |
| Question             | Add a question.                                                                                                                 | /question            |
| Flashcard            | Add a flashcard.                                                                                                                | /flashcard           |
| Case Connection      | Add a case. This feature adds an intro. section to the beginning of the brick and a conclusion section at the end of the brick. | /caseconnection      |
| Clinical Correlation | Add clinical information.                                                                                                       | /clinicalcorrelation |

### Beta Feature #5 – AI Assistant <a href="#beta-feature-5-ai-assistant" id="beta-feature-5-ai-assistant"></a>

Want to create brick questions and flashcards to test students’ knowledge as they are reading but struggling with what to write? Let the embedded AI assistant help.

To quickly create a question or flashcard, type **/ai** and select one of the following options:

<div align="left"><figure><img src="https://1583207202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVLYSduVGJDMCiOYAxBmQ%2Fuploads%2Fm7ZusiwNANegC4DTN476%2Fai-prompt.png?alt=media&#x26;token=571d304d-9bab-4782-80d9-b1501d2225b7" alt="" width="380"><figcaption><p>/ai promt</p></figcaption></figure></div>

**Question**. When selected, the AI Assistant inserts a single, active-learning question based on the text preceding the insertion point.

<div align="left"><figure><img src="https://1583207202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVLYSduVGJDMCiOYAxBmQ%2Fuploads%2FZCQ9iCUZ0cXSRUfemGCH%2Fai-question.png?alt=media&#x26;token=4399e5b5-fd58-4493-8392-506184c5d3ab" alt="" width="269"><figcaption></figcaption></figure></div>

**Flash Card**. When selected, the AI Assistant embeds a single flash card based on the text preceding the insertion point.

**\[FRONT OF CARD]**

<div align="left"><figure><img src="https://1583207202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVLYSduVGJDMCiOYAxBmQ%2Fuploads%2FyrelZMkGrY8zyJuAneNB%2Fai-flashcard.png?alt=media&#x26;token=c40f7da6-1cd0-4209-86b3-b7c182c4d07e" alt=""><figcaption></figcaption></figure></div>

**\[BACK OF CARD]**

<div align="left"><figure><img src="https://1583207202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVLYSduVGJDMCiOYAxBmQ%2Fuploads%2FIC2vHZNkVcl1MBehPwfr%2Fai-flashcard-back.png?alt=media&#x26;token=1cc0968b-23f3-4689-a259-f884295ada1c" alt=""><figcaption></figcaption></figure></div>

### Brick Voiceovers <a href="#brick-voiceovers" id="brick-voiceovers"></a>

<div align="left"><figure><img src="https://1583207202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVLYSduVGJDMCiOYAxBmQ%2Fuploads%2FlHaRslCXCPnZY443CaRb%2Fbrick-player.png?alt=media&#x26;token=f4ac7503-e446-4132-bcda-dd3d2a72963f" alt=""><figcaption></figcaption></figure></div>

Brick Voiceovers provide customers with a method to listen to the content of a brick. A transcript is created from our brick data, with additional cues & transitions, and then we use Azure text-to-speech services to generate an audio file. The following vignette types are skipped:

* Images
* Image carousels
* Videos
* Embeds
* Equations

On the web, customers have a method to:

* Play
* Pause
* Skip ahead
* Increase playback speed

{% hint style="info" %}
**Note*****:*** This feature will be available on both mobile platforms in a subsequent release.
{% endhint %}

### Bricks Create – Link Brick <a href="#bricks-create-link-brick" id="bricks-create-link-brick"></a>

Bricks Create now provides a method to link to another brick within a ScholarRx collection. Any user who can create (author) a brick may use this feature.&#x20;

To link to another ScholarRx brick, highlight the desired text in the brick and select the ‘Link Brick’ option from the toolbar.

<div align="left"><figure><img src="https://1583207202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVLYSduVGJDMCiOYAxBmQ%2Fuploads%2F9VJ6FZonK6ZctAEtG5sw%2Fbrick-links.png?alt=media&#x26;token=80128ed5-363e-4e1b-8715-464068bd61c2" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
**Note**: You may link to a brick even when you do not have a subscription to the brick collection; however, only a brick preview is displayed when a user does not have a subscription to a linked brick.
{% endhint %}

When the brick is published and the link is clicked in the Exchange, the brick will open in a new tab.

## Enhancements/Updates <a href="#enhancementsupdates" id="enhancementsupdates"></a>

### Institutional Onboarding Flow <a href="#institutional-onboarding-flow" id="institutional-onboarding-flow"></a>

The Institutional Onboarding flow has been enhanced to clarify the onboarding process.

Every user will see the welcome page after a valid magic link is clicked, even if they already have an existing B2C (personal) subscription. By clicking the ‘Accept’ button, users are agreeing to our Terms of Service and Privacy Policy.

<div align="left"><figure><img src="https://1583207202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVLYSduVGJDMCiOYAxBmQ%2Fuploads%2FnSFzb49ywhkSZmefjNvN%2Finst-onboarding.png?alt=media&#x26;token=08483b67-cafc-4f81-81d8-e02cc45f417e" alt=""><figcaption></figcaption></figure></div>

When the magic link is invalid (i.e., the link is inactive or there is a typo in the URL), this page displays instead.

<div align="left"><figure><img src="https://1583207202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVLYSduVGJDMCiOYAxBmQ%2Fuploads%2F2BGe0qlY7bvzZtYdsGdh%2Finst-invalid-code.png?alt=media&#x26;token=3fefaf83-08af-42a9-b0a7-0b5cb9deae51" alt=""><figcaption></figcaption></figure></div>

After clicking the ‘Accept’ button on the welcome page, users are prompted to log in through Edlink with their school account.

When the login is successful (i.e., a successful login may only be achieved when the email address is on the whitelist domain that was created when the magic link was created), the introduction page displays. To continue, the user must click the ‘Accept’ button to signify that they agree to the conditions displayed on this page.

<div align="left"><figure><img src="https://1583207202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVLYSduVGJDMCiOYAxBmQ%2Fuploads%2FSmEwOaQy8kCvJ4beIJ4C%2Finst-agreement.png?alt=media&#x26;token=bae135a3-0aed-45b0-9844-9762872151d6" alt=""><figcaption></figcaption></figure></div>

If the user already has B2C (personal) subscriptions that overlap with the subscription(s) the institution is providing; they are still onboarded & given any applicable roles; however, a page displays to inform them to contact Customer Service to request that their B2C subscription(s) be paused.

***Note: Pausing a B2C subscription is optional and up to the user to initiate.***

Should a user sign in with an Email that is not included on the institution’s whitelist, the following page is displayed.

<div align="left"><figure><img src="https://1583207202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVLYSduVGJDMCiOYAxBmQ%2Fuploads%2FiSDlhBYKwZ4lblZtmn3q%2Finst-invalid-email.png?alt=media&#x26;token=75dac383-5f78-4684-b7af-63fb69d8afd8" alt=""><figcaption></figcaption></figure></div>

### Search – Remove First Aid Copy & Share Options <a href="#search-remove-first-aid-copy-share-options" id="search-remove-first-aid-copy-share-options"></a>

Due to ScholarRx’s licensing agreement with the publisher of the First Aid USMLE-Rx book, the options to copy and share a First Aid fact have been removed.

**\[Before]**

<div align="left"><figure><img src="https://1583207202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVLYSduVGJDMCiOYAxBmQ%2Fuploads%2FtHCTz8hVDjTJPqfbhWSo%2Ffa-copy-before.png?alt=media&#x26;token=5acf4e7a-d804-491c-8328-b3c0eaefc7d6" alt=""><figcaption></figcaption></figure></div>

**\[After]**

<div align="left"><figure><img src="https://1583207202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVLYSduVGJDMCiOYAxBmQ%2Fuploads%2Fi0LHGg2T9j7LCUkyXCPR%2Ffa-copy-after.png?alt=media&#x26;token=41ea068a-c805-4638-8ece-680d5c8d8cb7" alt=""><figcaption></figcaption></figure></div>

### Search Upgrade – Brick Exchange <a href="#search-upgrade-brick-exchange" id="search-upgrade-brick-exchange"></a>

Faculty & students may now search for Bricks on the Brick Exchange by:

* **Author**. Bricks published by the author are returned in the search. The supported author types include primary author, author, & senior author.
* **Organization**. Bricks published by the organization are returned in the search results.
