# Комментирование

### Комментирование <a href="#id-4a28bfpuqqkj" id="id-4a28bfpuqqkj"></a>

Режим комментирования – режим, в котором пользователи могут оставлять комментарии и вести обсуждение внутри редактора. Для перехода в режим комментирования нажмите иконку **«Комментарий»** на верхней панели.

<figure><img src="https://3865113055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGDNAf78MjCvzZdPg7TdO%2Fuploads%2Fv8862IVFfCXQZNgwwzsR%2FScreenshot%202024-10-23%20at%2013.28.52.png?alt=media&#x26;token=e611f199-469b-46f8-8e2e-43a478764530" alt=""><figcaption></figcaption></figure>

### Как оставить комментарий? <a href="#aox4lii73ufg" id="aox4lii73ufg"></a>

Комментарий можно оставить к блоку и к элементу.

#### **Комментарий к блоку**

Чтобы оставить комментарий к блоку:

1. Перейдите в режим комментирования.
2. С помощью появившейся иконки комментария нажмите на пустое место возле нужного блока (появится зеленый контур).
3. Напишите комментарий.

<figure><img src="https://3865113055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGDNAf78MjCvzZdPg7TdO%2Fuploads%2F8H19dFESehh2FKtYt6gS%2FScreen%20Recording%202024-10-23%20at%2013.21.59.gif?alt=media&#x26;token=620dd577-8d68-4a3a-a334-1ddc281a14f7" alt=""><figcaption></figcaption></figure>

Слева от блока появится иконка с аватаром пользователя, оставившего комментарий. По клику на нее открывается окно, в котором можно быстро оставить ответ на комментарий, отметить его как решенный, удалить, закрепить, а также изменить.

<figure><img src="https://3865113055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGDNAf78MjCvzZdPg7TdO%2Fuploads%2FsmKdUBDwx09NOnudMjQy%2FScreen%20Recording%202024-10-23%20at%2013.57.25.gif?alt=media&#x26;token=18d9ef4d-54e1-48a6-9c9d-36c44c44947f" alt=""><figcaption></figcaption></figure>

#### **Комментарий к элементу**

Чтобы оставить комментарий к элементу следуем той же логике:

1. Перейдите в режим комментирования.
2. Найдите нужный блок.
3. Выделите элемент (нажмите на него иконкой комментирования).
4. Напишите комментарий.

<figure><img src="https://3865113055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGDNAf78MjCvzZdPg7TdO%2Fuploads%2FmjU91MyB2IBd3bxEO8e7%2FScreen%20Recording%202024-10-23%20at%2013.42.50.gif?alt=media&#x26;token=1ad786cc-def1-4909-9780-3a00ca7ffddd" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
К одному элементу/блоку можно добавить неограниченное количество комментариев. При этом иконка будет отображать количество комментариев на этом элементе/блоке.
{% endhint %}

<figure><img src="https://3865113055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGDNAf78MjCvzZdPg7TdO%2Fuploads%2FKcQ2KBQ70BZ4C6vj9Mfq%2FScreenshot%202024-10-23%20at%2014.26.32.png?alt=media&#x26;token=ee84c677-766f-45de-be68-8e1ebe06adb0" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Правое боковое меню со всеми комментариями можно свернуть, нажав на крестик. Снова развернуть его можно кликнув на иконку "Панель комментирования" в правом верхнем углу.
{% endhint %}

<figure><img src="https://3865113055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGDNAf78MjCvzZdPg7TdO%2Fuploads%2FsG7gI44a2PY7LiiVz0le%2FScreen%20Recording%202024-10-23%20at%2016.55.58.gif?alt=media&#x26;token=ff0dc3cc-92f7-465b-883f-8372145e9312" alt=""><figcaption></figcaption></figure>

### Комментарий <a href="#cynycnhjdm69" id="cynycnhjdm69"></a>

#### Обсуждение

Обсуждение – это ответы на верхнеуровневый комментарий.

Обсуждение открывается по клику на иконку слева от блока/элемента, а также по кнопке с количеством ответов в правом боковом меню.

<figure><img src="https://3865113055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGDNAf78MjCvzZdPg7TdO%2Fuploads%2FjgjpQXeKHJkstxBxOgfL%2FScreen%20Recording%202024-10-23%20at%2017.20.27.gif?alt=media&#x26;token=9dc31439-8555-4284-83ae-28301a1e027b" alt=""><figcaption></figcaption></figure>

#### Подписки на комментарии <a href="#vnenmutcmse6" id="vnenmutcmse6"></a>

Подписка на комментарии говорит, что пользователь будет получать уведомления о комментарии и отслеживать его состояние.

На комментарий автоматически подписаны:

* автор комментария;
* пользователи, упомянутые в верхнеуровневом сообщении.

Пользователи, упомянутые в обсуждении, не подписаны автоматически на получение уведомлений, но могут подписаться вручную в настройках комментария (в выпадающем меню или правом боковом меню).

От комментария также можно отписаться:

<figure><img src="https://3865113055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGDNAf78MjCvzZdPg7TdO%2Fuploads%2FY5QwpRVS26dg1GygqmLh%2FScreenshot%202024-10-23%20at%2014.44.56.png?alt=media&#x26;token=e71c1581-6a65-4e02-8f9b-fe211c5b15f2" alt=""><figcaption></figcaption></figure>

### Состояния комментариев <a href="#id-8tzj5hjcu59p" id="id-8tzj5hjcu59p"></a>

Комментарии имеют следующие состояния:

1. Прочитанные и непрочитанные.
2. Решенные и нерешенные.

***Прочитанные и непрочитанные комментарии***

{% tabs %}
{% tab title="Прочитаннные комментарии" %}

<figure><img src="https://3865113055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGDNAf78MjCvzZdPg7TdO%2Fuploads%2FPRphTxe669EnWnLnTu3Z%2FGroup%203392.png?alt=media&#x26;token=508b8de6-ab1b-4748-9120-cc1d55425cfe" alt=""><figcaption><p>Прочитанные сообщения отображены в сером цвете</p></figcaption></figure>
{% endtab %}

{% tab title="Непрочитаннные комментарии" %}

<figure><img src="https://3865113055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGDNAf78MjCvzZdPg7TdO%2Fuploads%2FHI9kD4u2mV6hWh7MjfYm%2FGroup%203391.png?alt=media&#x26;token=436740a4-5c0d-46ef-a721-77c7da8952dc" alt=""><figcaption><p>Непрочитанные сообщения имеют иконку зеленого цвета рядом с аватаром<br> пользователя, оставившего комментарий</p></figcaption></figure>
{% endtab %}
{% endtabs %}

Непрочитанными считаются все новые комментарии для пользователя.

***Решенные и нерешенные комментарии***

Состояние отображает, отмечен верхнеуровневый комментарий как решенный или нет.

Нерешенные комментарии – все новые комментарии.

Решенные комментарии не отображаются в правом боковом меню. Чтобы увидеть решенные комментарии, необходимо включить фильтрацию.

<figure><img src="https://3865113055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGDNAf78MjCvzZdPg7TdO%2Fuploads%2FEyyOR72ptt90TBYzfRDV%2FScreenshot%202024-10-23%20at%2017.27.07.png?alt=media&#x26;token=4e83f32a-8e19-4f50-9569-a98be79980bc" alt="" width="178"><figcaption></figcaption></figure>

### Навигация по комментариям <a href="#f31gvapusadn" id="f31gvapusadn"></a>

Переключаясь между вкладками «Все» и «Секция» в правой боковой панели, вы можете просмотреть либо все комментарии в проекте, либо только комментарии к секции, в которой вы находитесь.

<figure><img src="https://3865113055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGDNAf78MjCvzZdPg7TdO%2Fuploads%2F5wkb0iUfOS5wO8aBzR8s%2FScreen%20Recording%202024-10-24%20at%2011.21.58.gif?alt=media&#x26;token=f0df09d3-b5e7-4c01-8570-375e7585c049" alt=""><figcaption></figcaption></figure>

Нажатие на комментарий в правом боковом меню раскроет выпадающее окно с его обсуждением , что облегчит определение его местоположения в проекте.

<figure><img src="https://3865113055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGDNAf78MjCvzZdPg7TdO%2Fuploads%2Fj1jvgY9812ME2FMm93Bv%2FScreen%20Recording%202024-10-24%20at%2011.29.15.gif?alt=media&#x26;token=bbae9cf5-f42a-491e-b9b1-69ab09ac7e69" alt=""><figcaption></figcaption></figure>

### Уведомления <a href="#f31gvapusadn" id="f31gvapusadn"></a>

Уведомления о комментарии или ответе получают:

* все подписанные пользователи,
* все упомянутые пользователи.

Уведомления о каждом сообщении приходят на почту и в меню уведомлений (иконка **«Колокольчик»**) на уровне компании. В каждом уведомлении есть ссылка, которая ведет к секции с комментарием.