> For the complete documentation index, see [llms.txt](https://docs.b2ihealthcare.com/snowray/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.b2ihealthcare.com/snowray/reference/issue-management.md).

# Issue management

Users can leave comments, suggestions, and other feedback they encounter during authoring in the form of issues. These can be created for specific resources and are maintained on a dedicated page called Issues.

Issues can be accessed in two ways: from the global Issues page and the Resource specific Issues page.&#x20;

## Global Issues Page

The global page provides a list-style overview of all the issues created in Snowray.&#x20;

![Global Issues View](/files/ykLgaU8aS5E85E9q4HNr)

The listed issues are displayed with their `title`, along with the `resource` that is referenced by the issue, the users involved in that issue, i.e. `participants`, and the number of `comments` made on the issue.&#x20;

{% hint style="info" %}
Open issues are represented by <img src="/files/AD73pt5Xf3KE4OhSTWyb" alt="" data-size="line">, while resolved ones have <img src="/files/USgPjCte2HUa4ImMnYsa" alt="" data-size="line"> next to their title.
{% endhint %}

In addition to visual indicators, several filters can be applied to refine the view, for example, to show only resolved or open issues. The search bar can also be used to filter for issues that have the search term in their title.

Pressing the <img src="/files/-MgF_7lK96B0cNPVQTro" alt="" data-size="line"> icon reveals the advanced search widget with additional filter options.

{% hint style="info" %}

* To display issues created by yourself, press the *Created by Me* option.
* To filter for issues where you made a comment, i.e. you are a participant of an issue, press the *Mentions* option.
* To sort issues by title or creation time, select the corresponding option from the dropdown items.
  {% endhint %}

## Resource Issues Page

An Issues page is also available amongst the tabs of a resource, which is dedicated to the specific resource - let it be a Value Set, Code System, or a Bundle - and as a result, lists issues related only to the corresponding resource.

![Issues tab of a Value Set](/files/DECpHdWSLasSuETHxeQe)

The page has a similar layout to the one that can be seen on the global Issues page, with the exception of displaying the Resource title. All the functions are available on the resource-specific issue page as well, i.e. users can apply different filters to refine the list.

## Issue layout

Opening an issue is as easy as clicking on the title in the list. This will navigate users to the Issue overview page, where further details are available.

![Layout of an Issue](/files/Hds0wNDy1duRuRwizZxW)

{% hint style="info" %}
If you want to reference an issue to a team member, simply click on the <img src="/files/nNPRQXJbq67avAbiBAfA" alt="" data-size="line"> icon to copy the URL.

You can also direct team members to a specific comment by copying the comment link instead.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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.b2ihealthcare.com/snowray/reference/issue-management.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.
