Collaborate with others

Use the real-time collaboration features to track changes, add comments, and access the revision history for model documentation and validation reports.

Feature highlights

• Real-time collaboration — Simultaneously edit model documentation, leave and respond to comments and suggestions, and access revision history. Changes to model documentation are also automatically added to ​ValidMind’s activity feed.

• Spell and grammar checker — Have your content checked automatically by the built-in spell and grammar checker.

• Math formulas — Add math formulas to documentation by clicking the MathType button and using the toolbar, or switch to handwriting.

Prerequisites

• You are logged in to ValidMind.
• The model you are documenting is registered in the model inventory.¹
• Model documentation has submitted for review or validation by the model validation team.²
• You are a Developer or Validator, or assigned another role with sufficient permissions to perform the tasks in this guide.³

¹ Register models in the inventory

² Working with model documentation

³ Manage permissions

Tracking changes

While working with content blocks in documentation,⁴ you can suggest changes instead of editing the text directly.

⁴ Work with content blocks

Suggest a change

1. Click the Track changes button in the toolbar to turn on suggestion mode.

2. Make your changes to the model documentation.

   When changes tracking is enabled, other contributors can accept or decline the suggested changes.

Resolve changes

1. Suggested changes appear in green or red highlighted text, depending on if the change is adding or removing content respectively.

   • To accept or decline a change, click the highlighted text, then click or .
   • You can also reply to a suggested change.

2. To mass accept or decline suggestions, click the dropdown arrow next to the Track changes button and select one of the options:

   • Accept all suggestions
   • Accept all selected suggestions
   • Discard all suggestions
   • Discard all selected suggestions

Revision history

While working with content blocks in documentation,⁵ you can save named versions of your edits to retain specific revisions you’d like to keep.

⁵ Work with content blocks

1. Click the Revision history button in the toolbar.

2. Once you save a version, you can then view revision history, compare versions, rename versions, or restore to a previous version.

3. Select Save current version to save your current version:

   1. Optionally, enter a version name.
   2. The default name is the date and time the latest change was made.

View revision history

1. Click Revision history and select Open revision history to view a history of all saved versions as well as your current version.

2. To see the the change made with each version, select the version in the right sidebar.

   • Changes made in that version are highlighted.
   • Hover over the highlighted content to see who made the change.

Compare versions

1. Click Revision history and select Open revision history.

2. Click on the version you would like to compare another version to.

3. Hover over the other version to compare with your first version.

4. When the appears, click on it and select Compare against selected.

Rename a version

1. Click Revision history and select Open revision history.

2. Click on the title of the version you want to rename to change it.

Restore a version

1. Click Revision history and select Open revision history.

2. Click on the desired version and select Restore this version.

3. The restored version will now appear under revision history with the name: Restored: 'version name'.

Commenting

While working with content blocks,⁶ you can comment directly on specific portions of the text.

⁶ Work with content blocks

⁷ Customize your dashboard

All users associated with a model, such as model developers and model validators, will see a notification that a comment has been posted in their Recent Activity feed, accessible via the Dashboard.⁷

Post comments

1. In any text block or test description, select the portion of text you want to comment on, then click the button that appears.

2. Enter your comment and click Comment.

3. You can view the comment by clicking the highlighted text. Comments will also appear in the right sidebar.

Reply to comments

1. Click the highlighted text to view the comment thread.

2. Enter your comment and click Reply.

3. You can view the comment thread by clicking the highlighted text.

Resolve comments

1. Click the highlighted text portion to view the thread, then click to resolve the thread.

2. To view the resolved comment thread, click the Comments archive button in the toolbar.

   You can view a history of all archived comments in the Comment archive.

To reopen a comment thread, reply to the comment thread in the Comment archive or click the Reopen button in the header of that comment thread.

Edit comments

1. Click the highlighted text portion to access the comment thread.

2. Click the icon for the corresponding comment and select Edit.

3. Edit your comment and click Save.

To edit a comment in a resolved thread, follow the same steps but click the Comments archive button first to access the resolved thread.

Delete comments

1. Click the highlighted text portion to access the comment thread.

2. Click the icon for the corresponding comment and select Remove.

3. After you confirm, the comment will be deleted.

To delete a comment in a resolved thread, follow the same steps but click the Comments archive button first to access the resolved thread.

What’s next

• Preparing validation reports
• Working with model findings
• View model activity