# Report Tasks

{% hint style="info" %}
Note that depending on your individual access level, you might not have the permission to make comments or create tasks!
{% endhint %}

Users can make comments on specific files on the right hand side of a report. While global report comments are designed for more general discussion, these inline comments should be reserved for specific actions - or tasks - on a report.

<figure><img src="/files/7UgrP5SU8CIyx6k8Ddcy" alt=""><figcaption><p>File-specific Commenting</p></figcaption></figure>

It is important for users to remember that these comments are file specific. So if one makes a comment on the main PowerPoint file, but then browses to a separate .png file in the report, that comment will disappear from view while browsing.

{% hint style="info" %}
Note that users can also apply comment statuses to file comments (i.e. comment threads on the right-hand side of a report, which pertain to the specific file that is currently open in the report. General report comments (at the bottom of a report) do not have task statuses.
{% endhint %}

<figure><img src="/files/MotqItRyo7c6Xv2R3NHr" alt=""><figcaption><p>Task Statuses</p></figcaption></figure>

## Jupyter Notebooks

Jupyter-based reports have inline comments / tasks. Users can comment directly on a specific Jupyter notebook cell on Kyso - whether that be code input or a graphical output - just as they would on Google Docs or Notion.

<figure><img src="/files/6a6vmcDBq6isHskW8o1O" alt=""><figcaption><p>Inline Comments</p></figcaption></figure>

Remember that, because inline comments rely on cell ids, if one makes a comment on a specific cell, and later the author makes changes/updates the report, deleting that cell in the process, that comment will also be removed when the new version is pushed back to Kyso.

## Managing Tasks

As multiple versions are created on a Kyso report, users need a way to view & interact with a list of all comments on the report across different versions. We have created a report tab where users can view all comments made across a report’s entire lifecycle. Users can also now apply comment "statuses" to file & inline comments (similar to Google Docs), so teams can manage ongoing work needed on a project.

At the top of the report page, the author (or admins) can view a "Report Tasks" page to see all comments made on the report:

<figure><img src="/files/ASWU5w80tsFiOGWoY6NH" alt=""><figcaption><p>Tasks tab on a Kyso report</p></figcaption></figure>

And users can view all tasks here across report versions, either as a list or a kanban view:

<div><figure><img src="/files/SNQFdOAjBCw4mdpBkgDI" alt=""><figcaption><p>Kanban View</p></figcaption></figure> <figure><img src="/files/oEqIZOKIfN3ke00oJ7Ht" alt=""><figcaption><p>List View</p></figcaption></figure></div>

When a user clicks on a task, they are taken to that task with a status history of the comment thread & the cell or file to which the task pertains:

<figure><img src="/files/RkU9OgOvQUa9MqjxK7Py" alt=""><figcaption><p>Task &#x26; comment thread history</p></figcaption></figure>

## Orphaned Report Tasks

Remember that because tasks are linked to a specific cell in a notebook report, if that cell is deleted on a new version of the report, this effects how you interact with that task.&#x20;

Following the same steps from above, let's say you create a task on a report. In a later version, that cell is deleted. If you - or any other user - clicks on that task in the report tasks page, **this will link you to the latest version of the report when the cell to which that task relates still exists.**

## Managing User Tasks

Similar to a platform like Gitlab, users can also view, manage and interact with all tasks that have been assigned to them across all Organisations & Channels to which they have access.

Simply click on the tasks icon in the top navigation bar:

<figure><img src="/files/09JeEa88HKefAUI7G03s" alt=""><figcaption><p>Tasks Overview</p></figcaption></figure>

On the next page you will see all tasks that are relevant to you. You can filter through these tasks just like you would on Gitlab, by task author, status, creation date & Organisation.

<figure><img src="/files/xAqUVPen2re9hyYY1uVa" alt=""><figcaption><p>User Tasks Page</p></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.kyso.io/collaboration/report-tasks.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
