Datalore
 
2023.4
Shortcuts: Windows
Get a demo
  1. Notebook editor
  2. Comments

Comments

Last modified: 06 September 2023

Use comments to improve and facilitate collaboration on notebooks and reports.

Add comments in notebooks or reports

The comments feature works on the cell level. You can leave a comment to any specific cell in the notebook or report. Each original comment starts a thread that will contain the initial comment and all respective replies.

  1. Open the notebook or report.

  2. Click the Add comment icon next to the upper-right corner of the cell. If there are no comments left to the cell yet, the icon is grayed out; if there are comments, the icon is green.

  3. In the comment view, click Add comment. A text field will appear in the comment view.

  4. In the text field, type your comment.

  5. After the comment is written, click the Post button.

After a comment is added:

  • A separate thread is created that will contain the original comment and all replies to it. Multiple comments form a stack of threads, all displayed in the same comment view for the respective cell.

  • If added to a cell in the report, such a comment will be marked with a REPORT label.

    note

    Comments added in a notebook are not displayed in the respective report.

In the image below, you can see a comment view with two threads. One of the comments was added in the report and marked accordingly.

Comment view with two threads

Further actions on comments

note

Comparing comments in notebooks and reports

The procedures below are about managing comments made both in notebooks and reports. However, working on comments in reports has the following limitation: you can only view and manage comments added in reports; comments added in the respective notebook are not displayed, and therefore manageable, in reports.

Reply to a comment

Participate in collaboration by replying to notebook or report comments.

  1. Find the comment you want to reply by navigating to the respective cell.

  2. Click the View comments icon.

  3. Click Reply. (Optional) If there are several threads to the cell, make sure you reply to the right comment.

    Replying to a comment

  4. In the text field, type your reply and click Post.

The reply you made will be added to the respective thread.

Resolve notebook comment threads

Users with editor rights can resolve comment threads. By doing so, you hide a comment thread from the comment view and disable the replying option. You can later reopen a resolved comment thread to make it active again.

  1. Navigate to the cell with the comment thread you want to resolve and click the View comments icon.

  2. Hover over the thread and click the Resolve thread icon.

  3. (Optional) To view the resolved thread, click the View [n] resolved thread(s) line on top of the comment view.

    View resolved threads

Reopen or delete notebook comment threads

You can reopen or delete an unresolved thread so that users can view it and leave replies.

  1. In the notebook, navigate to the cell with the resolved comment thread you want to reopen and click the View comments icon.

  2. Click the View [n] resolved thread(s) line on top of the comment view. You will see the stacked resolved threads.

  3. Hover over the thread you want to reopen and click the More actions icon.

  4. Seleсt one of the options:

    • Reopen thread to make the thread active again.

    • Delete to delete the thread. Complete the action by confirming it in the confirmation dialog.

Edit a comment

As the author of an original comment or reply, you can edit its text.

  1. Navigate to the comment you want to edit and click the View comments icon.

  2. In the comment view, hover over the comment/reply and click the More actions icon.

  3. Select Edit from the dropdown.

  4. Edit the text and click the Save button.

Delete a comment

Users with editor rights can delete a comment.

note

Important

If you delete a top level, or original, comment, the whole thread with all comments will be deleted too.

  1. Navigate to the comment you want to delete and click the View comments icon.

  2. In the comment view, hover over the comment/reply and click the More actions icon.

  3. Select Delete from the dropdown.

  4. Confirm the action in the confirmation dialog.