Customize documentation templates
The ValidMind AI risk platform offers robust and fully customizable templates for model documentation and validation reports. Configure these templates via multiple methods to suit your organization’s unique needs.
- Templates are versioned and saving a documentation template after making changes or reverting to a previous version state always creates a new version, or you can duplicate templates to create new independent templates in your library.
- Documentation templates are stored as YAML files edited directly using the advanced editor, allowing you full control over the minitua such as desired guidelines.
- We also provide a simplified editing experience to allow you to easily construct and rearrange the outline of your template.
Prerequisites
Edit template outline
In the left sidebar, click Settings.
Under Workplace Settings, select Templates.
Select one of the tabs for the type of template you want to edit:
- Documentation
- Validation Report
- Ongoing Monitoring
Locate the template to edit and on the template details page, click Edit Outline.
In outline editing mode, you can:
- Expand sections:
- Expand the menu for any sections with subsections by clicking .
- Add content to sections:
- For validation report templates, you’re able to add additional content.
- Click to add content to that section of the template, such as a Summary Block or a Guideline Block.4
- Rename sections:
- Hover over a section until the appears, then click on it to change the name.
- Save by clicking , and discard changes by clicking .
- Insert new sections:
- Click to add a new section or subsection to the template.
- To add a section above the current section, select Section Before.
- To add a section below the current section, select Section After.
- To add a subsection within the current section, select Subsection.
- Remove sections:
- Click to delete a section.
- After you confirm, that section will be removed.
- Reorder sections:
- Click and hold firmly to drag to reorder sections.
- Expand sections:
When you’re done, click Create New Version to view a side-by-side comparison of your changes with the previous version:
- Add a description in version notes to track your changes.
- Click Save to save the new version.
Once saved, your new template version becomes available for use.
Edit YAML template
In the left sidebar, click Settings.
Under Workplace Settings, select Templates.
Select one of the tabs for the type of template you want to edit:
- Documentation
- Validation Report
- Ongoing Monitoring
Locate the template to edit and on the template details page, click Edit Raw.
In the Edit Template YAML editor that opens, make your changes according to the template schema,5 then click Continue to view a side-by-side comparison of your changes with the previous version of the template.
On the Review Changes screen:
- Add a description in version notes to track your changes.
- Click Save Version # to save the new version.
Once saved, your new template version becomes available for use.
Template schema
Unique identifier for the template.
Name of the template.
Version of the template.
Description of the template.
Documentation sections of the template.
Each item of this array must be:
Unique identifier for the section.
Title of the section.
Description of the section.
ID of the parent section.
Order of the section in the navigation menu. By default sections are ordered alphabetically. If order is specified, sections will be ordered by the order value, and then alphabetically.
Default text for the section. If set, a metadata content row will be created with this text when installing the template
If true, the section will be displayed in the navigation menu, but it will not be accessible via direct link.
If true, the section will condense all of its subsections into a single section.
Documentation or validation guidelines for the section.
Each item of this array must be:
Contents to be displayed on the section.
Each item of this array must be:
Single content block of the module.
Must be one of:
- "metadata_text"
- "dynamic"
- "metric"
- "test"
"metadata_text"
"test"
ID of the content to be displayed for the given content type (text, tests, etc.).
"sample_text"
"section_intro"
Options for the content block.
{
"default_text": "This is a sample text block."
}
{
"metric_id": "metric_1",
"title": "Custom Title for Metric 1"
}
{
"test_id": "adf_test"
}
Default text for the content block. Only applicable for metadata_text content blocks.
Title of the content block. Only applicable for test content blocks.
Duplicate template
To duplicate an existing template and start with version one of that new template:
In the left sidebar, click Settings.
Under Workplace Settings, select Templates.
Select one of the tabs for the type of template you want to duplicate:
- Documentation
- Validation Report
- Ongoing Monitoring
Locate the template to duplicate and on the template details page, click Duplicate Template.
In the Duplicate Template YAML editor that opens, give your copy a template name.
Optionally, you can also add a template description.
Click Duplicate Template to create a copy of your template.
Once duplicated, customize your new template to your needs, making it available for use with model documentation or validation reports.
Troubleshooting
The documentation template editor validates the YAML changes you make and flags any errors that it finds. If you make a change that the editor cannot parse correctly, the editor will not let you save the changes until you correct the YAML.
Common issues with YAML include incorrect indenting, imbalanced quotes, or missing colons between keys and values. If you run into issues with incorrect YAML, check the error message provided by the template editor, as it might provide a line and column number where the error occurs.