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
Tracking changes
While working with content blocks in documentation,4 you can suggest changes instead of editing the text directly.
Suggest a change
Click the Track changes button in the toolbar to turn on suggestion mode.
Make your changes to the model documentation.
When changes tracking is enabled, other contributors can accept or decline the suggested changes.
Resolve changes
Suggested changes appear in green or
redhighlighted 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.
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,5 you can save named versions of your edits to retain specific revisions you’d like to keep.
Click the Revision history button in the toolbar.
Once you save a version, you can then view revision history, compare versions, rename versions, or restore to a previous version.
Select Save current version to save your current version:
- Optionally, enter a version name.
- The default name is the date and time the latest change was made.
Click Revision history and select Open revision history to view a history of all saved versions as well as your current version.
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.
Click Revision history and select Open revision history.
Click on the version you would like to compare another version to.
Hover over the other version to compare with your first version.
When the appears, click on it and select Compare against selected.
Click Revision history and select Open revision history.
Click on the title of the version you want to rename to change it.
Click Revision history and select Open revision history.
Click on the desired version and select Restore this version.
The restored version will now appear under revision history with the name:
Restored: 'version name'
.
Commenting
While working with content blocks,6 you can comment directly on specific portions of the text.
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.7
Post comments
In any text block or test description, select the portion of text you want to comment on, then click the button that appears.
Enter your comment and click Comment.
You can view the comment by clicking the highlighted text. Comments will also appear in the right sidebar.
Resolve comments
Click the highlighted text portion to view the thread, then click to resolve the thread.
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
Click the highlighted text portion to access the comment thread.
Click the icon for the corresponding comment and select Edit.
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
Click the highlighted text portion to access the comment thread.
Click the icon for the corresponding comment and select Remove.
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.