Work with content blocks
Make edits to your model documentation, validation reports, or ongoing monitoring plans by adding or removing content blocks directly in the online editor.
What are content blocks?
Content blocks provide you with sections that are part of a template, and are used in model documentation, validation reports, and ongoing monitoring plans.
- You can think of these sections as an empty canvas that you fill in with text and test results.
- Multiple sections are joined to create a longer document with a table of contents that has different heading and subheading levels, such as “1.,” “1.1.,” and so on.
Content block types
- simple text block
- Can be added anywhere on model documentation, validation reports, or ongoing monitoring plans and edited to include additional documentation in text format.
- test-driven block
- Can be within model documentation and ongoing monitoring plans to display one of the supported test results collected by the ValidMind Library.
- metric over time block
- Can be added within model documentation and ongoing monitoring plans to display one of the supported metric over time results collected by the library.
Content editing toolbar
The content editing toolbar is a rich text editor that enables you to:
- Undo or redo changes
- Format your text, including adding hyperlinks and code blocks
- Insert LaTex formulas1
- Attach images via upload or URL
You can also use the toolbar to suggest changes, save named versions of content, and leave comments.2
Prerequisites
Add content blocks
In the left sidebar, click Inventory.
Select a model or find your model by applying a filter or searching for it.6
In the left sidebar that appears for your model, click Documentation, Validation Report, or Ongoing Monitoring.
You can now jump to any section of the model documentation, validation report, or ongoing monitoring plan by expanding the table of contents on the left and selecting the relevant section you would like to add content to, such as 1.1 Model Overview.
Hover your mouse over the space where you want your new block to go until a horizontal dashed line with a sign appears that indicates you can insert a new block:
Click and then select one of the available options:
After adding the block to your documentation, click on the text to make changes or add comments.9
Add mathematical formulas
While editing a simple text block, you can insert math equations using the editor:
Click √ in the toolbar while editing a content block.
You can use the interface to type out the equation, or paste in a LaTeX formula:
- Click Insert to add the equation to your content block.
Generate Text with AI beta
While editing a simple text block, you can have ValidMind assist you with generating content drafts:
Click beta (Generate Text with AI) in the toolbar while editing a content block.
Enter an optional prompt to guide the output, then click Generate to compose a draft for review.
Review the draft composed by the ValidMind AI Content Builder for accuracy and relevance, then:
- Click Accept Text to insert the draft into your content block.
- Click Try Again to regenerate a different draft.
- Click Cancel to discard the draft and return to your documentation section.
After you insert the AI-generated draft, click on the text box to make the necessary edits and adjustments to your copy:
- Ensure that content is in compliance with the quality guidelines outlined by your organization.
- Use the content editing toolbar10 just as you would with any other text block.
Remove content blocks
In the left sidebar, click Inventory.
Select a model or find your model by applying a filter or searching for it.12
In the left sidebar that appears for your model, click Documentation, Validation Report, or Ongoing Monitoring.
You can now jump to any section of the model documentation or validation report by expanding the table of contents on the left and selecting the relevant section, such as 1.1 Model Overview.
Select the block you wish to remove from the model documentation.
Click on located in either one of these locations:
- In the toolbar for text blocks
- In the single-button toolbar for test-driven or metric over time blocks
After you confirm, the content block is removed.
Test-driven or metric over time blocks can be re-added later on but text blocks are currently deleted permanently.