Datalore 2024.5 Help

Comment notebooks

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

Basic procedure

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.

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

  4. In the text field, type your comment.

  5. (Optional) To mention another user, do the following:

    1. Type @. This will open a list of users that you can mention.

      User list for mentions
    2. Click the user you want to mention. Their user name will appear in the text field for your comment.

    3. (Optional) To mention another user, repeat the steps.

  6. After you finish writing the comment, click the Post button.

Once your 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 box for the respective cell.

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

    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
  • Notebook/report owner and users mentioned in the comment are notified via email. If you don't want to get notifications, go to Account settings | Notifications and select the None checkbox.

    Disabling comment notifications

Further actions on comments

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.

  5. Click Go back to active threads to return to the unresolved threads.

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.

  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.

Keywords

comments, collaboration, leave comments, comment code

Last modified: 16 July 2024