Комментарии и предложения правок

База знаний хранит итог, а спрашивают чаще о том, почему он такой. Обсуждение живёт там же, где текст, — в самом документе.

Режим документа

Что делают ввод и выделение, выбираете вы сами — переключателем в строке над страницей, рядом с точкой сохранения:

Выше вашего уровня доступа подняться нельзя, ниже — сколько угодно; у читателя переключателя нет вовсе. По умолчанию стоит чтение, и это не осторожность ради осторожности: автосохранение срабатывает через полсекунды тишины, и открытый «просто посмотреть» чужой регламент иначе правится случайным нажатием.

Выбор запоминается для проекта. Ссылку на страницу можно отправить и сразу в нужном режиме — например, с ?mode=suggest, чтобы коллега открыл её на предложение правок.

Комментарии

Выделите фрагмент и нажмите «Комментировать» — тред встанет напротив своей строки, в колонке справа. Комментарий ко всей странице встаёт после текста. Сколько обсуждений открыто, видно плашкой над страницей и счётчиком 💬 в дереве.

• Треды с ответами. Разговор идёт в одном месте, а не рассыпается по репликам.
• Решение треда. Обсудили — тред закрывается и уходит из ленты, но не пропадает.
• Удаление мягкое. Удалённая реплика показывается строкой «комментарий удалён» и держит место в разговоре: тред, из которого выдернули реплику, перестал бы читаться. Вернуть её можно.
• Открепление. Якорь — это сам процитированный фрагмент, а не невидимая метка. Переписали кусок текста, к которому шёл разговор, — тред открепляется и переезжает в конец, а не показывает подсветку не в том месте.

Комментарии не попадают ни в текст страницы, ни в её выгрузку, ни в индекс поиска, ни в ответы ассистента: обсуждение документа — не сам документ. Страница без обсуждения выглядит и выгружается ровно так же.

На узком экране колонки нет — обсуждение открывается панелью.

Позвать человека

@ в поле реплики открывает список участников проекта; выбранный получит уведомление «Вас упомянули» со ссылкой на страницу. Уведомление приходит и без упоминания — тому, кто в этом треде уже писал, и всем участникам треда, когда его закрыли. См. Уведомления.

Упомянуть можно только участника проекта. Разметки в реплике нет никакой — обсуждение это не документ, и в тексте остаётся обычное @Имя Фамилия. Правка реплики список упомянутых не меняет: уведомление уже ушло, и дописать в него человека задним числом значило бы позвать того, кого при отправке не звали.

Предложения правок

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

• Пока вы печатаете, предложение — черновик: в чужом списке оно не висит и никого не дёргает, пока вы не нажмёте «Отправить». В дереве ваш черновик помечен ✎, над страницей — плашка с кнопками «Отправить» и «Посмотреть».
• Разбирает его тот, у кого есть право писать: экран проверки показывает построчный дифф, кнопки «Принять» и «Отклонить», и решать можно по отдельным правкам, а не только пачкой целиком.
• На самой странице стоит плашка: «по этому документу есть непринятое предложение». Её видит и читатель — знать, что страница в процессе, нужно всем.
• Решение возвращается к вам уведомлением: «вашу правку приняли» или «отклонили», с именем того, кто решил.

Это ответ на два несимметричных случая сразу: читателю есть чем возразить документу, а редактор не обязан пускать чужую правку в текст сразу.

Что пишется в журнал

Комментарии в журнал не идут — поток реплик вытеснил бы оттуда правки, ради которых лента заведена. Исключение одно: действия над чужой репликой (удалил, вернул) — это власть над чужим текстом.

Предложения пишутся: и то, что предложили, и то, чем кончилось.