Skip to content

Create CKEditor docs #112

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
wants to merge 14 commits into from
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions site/_quarto.yml
Original file line number Diff line number Diff line change
Expand Up @@ -114,6 +114,7 @@ website:
# - guide/assign-model-validators.qmd
- guide/comment-on-documentation-projects.qmd
- guide/work-with-validation-reports.qmd
- guide/use-the-ck-editor.qmd
# - guide/create-project-findings.qmd
# - guide/manage-project-findings.qmd
- guide/view-validation-guidelines.qmd
Expand Down
8 changes: 7 additions & 1 deletion site/_site/guide/guide.html
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head>

<meta charset="utf-8">
<meta name="generator" content="quarto-1.3.427">
<meta name="generator" content="quarto-1.3.361">

<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">

Expand Down Expand Up @@ -283,6 +283,12 @@
<a href="../guide/work-with-validation-reports.html" class="sidebar-item-text sidebar-link">
<span class="menu-text">Work with validation reports</span></a>
</div>
</li>
<li class="sidebar-item">
<div class="sidebar-item-container">
<a href="../guide/use-the-ck-editor.html" class="sidebar-item-text sidebar-link">
<span class="menu-text">Use CKEditor for Documentation Projects</span></a>
</div>
</li>
<li class="sidebar-item">
<div class="sidebar-item-container">
Expand Down
777 changes: 777 additions & 0 deletions site/_site/guide/use-the-ck-editor.html

Large diffs are not rendered by default.

113 changes: 54 additions & 59 deletions site/_site/notebooks/Introduction_Customer_Churn.html

Large diffs are not rendered by default.

511 changes: 398 additions & 113 deletions site/_site/notebooks/Quickstart_Customer Churn_full_suite.html

Large diffs are not rendered by default.

261 changes: 260 additions & 1 deletion site/_site/search.json

Large diffs are not rendered by default.

121 changes: 121 additions & 0 deletions site/guide/use-the-ck-editor.qmd
Original file line number Diff line number Diff line change
@@ -0,0 +1,121 @@
---
title: "Use CKEditor for documentation projects"
keywords: "use CKEditor for documentation projects, CKEditor, model risk management, ValidMind"
---

Learn how a model validator can use CKEditor to collaborate with model developers on a model documentation project. This topic is relevant for model validators who want to track changes across projects, add comments, and access revision history for real-time collaboration with model developers.


## Prerequisites

* You are a registered user on the ValidMind Platform
* The model you are documenting is registered in the model inventory
* A documentation project has submitted for review or validation by the model validation team
* You are logged into the ValidMind Platform

## Commenting

### Posting comments to the documentation

1. In any section of the model documentation, select a portion of text that you would like to comment on, and click the **Comment** button in the toolbar.

<!--- **Add image or gif of highlighting text and clicking on comment icon** --->

2. Enter your text comment and click **Comment**.

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

### Responding to an existing comment

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

2. Enter your text comment and click **Reply**.

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

### Resolving comment threads and viewing archived comments

1. To resolve a comment thread, click the highlighted text portion to view the thread, and then click the checkmark.

<!--- **Add image or gif** --->

2. To view the resolved comment thread, click the **Comment archive** button in the toolbar. You can view a history of all archived comments in the Comment archive.

3. To reopen a comment thread, you can reply to the comment thread in the Comment archive, or you can click the **Reopen** button that appears next to the highlighted text portion.

### Editing and deleting comments

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

2. To edit a comment in the thread, click the **More options** icon for the corresponding comment and click **Edit**.

3. Edit your comment and click **Save**.

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

::: {.column-margin}
::: {.callout-tip}
<!--replace this later -->
All users associated with a project, 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 ValidMind **Home** page.
:::
:::

## Tracking changes

### Suggesting a change

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

2. Make any desired changes to the documentation. When changes tracking is enabled, other project contributers can accept or decline the suggested changes.

### Accepting or declining suggestions

1. Suggested changes appear in green or red highlighted text, depending on if the change is adding or removing content. To accept or decline a change, click the highlighted text and click the corresponding button. You can also reply to a suggested change.

2. To mass accept or decline suggestions, click the dropdown arror next to the **Track changes** button and click the desired option.

## Revision history

### Saving a version

1. Click the **Revision history** button in the toolbar.

2. In the dropdown, click **Save current version** and optionally enter a version name. The default name is the date and time the latest change was made.

### Viewing revision history

1. Click the **Revision history button** in the toolbar, then click **Open revision history**. Here, you can view a history of all saved versions and 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 will appear highlighted. Hover over the highlighted content to see who made the change.

### Restoring a version

1. To restore a version, select the desired version and click **Restore this version**.

2. The restored version will now appear under revision history with the default name: "Restored: 'version name'". To exit revision history without restoring a version, click **Back to editing**.

## Real-time collaboration

Users can simultaneously edit the documentation project, leave and respond to comments suggestions, and access revision history. CKEditor is also integrated with ValidMind's activity feed, so changes to the documentation project are automatically added to the activity feed and can be accessed by project contributers.

## Additional features

- **Spell and grammar checker**.

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

- **Paste images, tables, and graphs from Office**.

- **Export to PDF and Word**.
<!---
## Troubleshooting

[Include any common issues or errors that may arise during the task and how to resolve them.]
--->

## Related topics

* [Work with Validation Reports](work-with-validation-reports.qmd)
<!---* [Create project findings](create-project-findings.qmd)
* [Manage project findings](manage-project-findings.qmd)--->
* [View validation guidelines](view-validation-guidelines.qmd)
893 changes: 892 additions & 1 deletion site/notebooks/Introduction_Customer_Churn.ipynb

Large diffs are not rendered by default.

Loading