Report Tasks
How your team can manage Gitlab-esque tasks in comment threads directly on Kyso reports
Note that depending on your individual access level, you might not have the permission to make comments or create tasks!
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.
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.
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.
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.
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:
And users can view all tasks here across report versions, either as a list or a kanban view:
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:
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.
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:
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.
Last updated
