# Overview

It is quite common to have multiple TODOs in a project referencing the same ticket. This allows developers to highlight related chunks of code and create a sort of task list, with each TODO acting as an anchor.

Catana includes a feature to improve this workflow and help resolve related TODOs.

<figure><img src="/files/ljlKecZ5YE5h2YOK28AD" alt="" width="563"><figcaption></figcaption></figure>

### Reference

Any TODO with a title that includes the keyword `Ref #123` (Where 123 is the number of a **opened** issue in your GitHub tracker) would be grouped together with other TODOs with the same reference.

<figure><img src="/files/xR9O7YhdcwQ74i7WDWUF" alt="" width="375"><figcaption></figcaption></figure>

The first time a ticket is referenced in a TODO, Catana creates a comment on the referenced issue, indicating the line and file that require attention.\
As more TODOs referencing the same ticket are added, Catana updates the previously created comment and the task list.

\
When a TODO that was part of a group is removed from the codebase, Catana reflects this and updates the task list.

<figure><img src="/files/5xQfOlgAWZ1GJydllIZl" alt="" width="563"><figcaption></figcaption></figure>

Finally, when all TODOs have been removed, Catana considers the ticket solved and will inform your team by commenting on the ticket.

<figure><img src="/files/fFZSqSXgBOzYhDKZa3B3" alt="" width="375"><figcaption></figcaption></figure>

{% hint style="info" %}
Any time a TODO that is part of a group changes location (line or file), Catana reflects the change.

The task list will always remain up to date, eliminating the need to search through the git history.
{% endhint %}

### Dashboard

When viewing a TODO item on the Catana dashboard, a list of related TODOs is displayed.

<figure><img src="/files/tvIUhuyuhHGfpN2YitTE" alt="" width="563"><figcaption></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.catana.dev/grouped-todos/overview.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.