Страницы

Как попросить ассистента собрать документ целиком, а не заготовку.

Здесь про страницы: тексты, таблицы, списки, предупреждения, папки и доступ.

Как составить запрос

Страница получается хорошей, когда в запросе сказаны три вещи:

Что это за документ — регламент, заметки к релизу, инструкция для новичка.
Из каких частей он состоит — что идёт первым, что вторым, чем заканчивается.
Что показать таблицей, что списком, а что предупреждением.

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

Собрать документ с нуля

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

Работает потому, что назван и порядок частей, и вид каждой: получится документ со структурой, а не сплошной текст, который потом придётся разбивать руками.

Дописать в существующую страницу

Открой страницу «Регламент дежурства» и допиши в конец раздел «Как откатиться, если что-то пошло не так».
Нужны нумерованные шаги и команда, которую надо выполнить, отдельным блоком кода.
Остальное на странице не трогай.

Работает потому, что сказано, куда дописать и чего не трогать. Без этого ассистент может переписать страницу целиком.

Привести в порядок

Покажи, какие страницы есть в проекте и что где лежит.
Если увидишь страницы про одно и то же — скажи, какие похожи.
Ничего не удаляй и не перемещай, сначала покажи список.

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

Когда нужно быстро

«Какие страницы есть в проекте?»
«Перенеси страницу «Регламент дежурства» в папку «Процессы»»
«Добавь эту страницу в избранное»
«Дай Алисе доступ на редактирование этой страницы»
«Вынеси длинный кусок про миграции под спойлер»

Что стоит знать заранее

Доступ и публикация — разные действия. Дать человеку роль на странице не означает опубликовать её в интернете или отправить приглашение в пространство. Назовите получателя и роль; существующая роль может быть заменена. Принятие приглашения — отдельное действие от имени вошедшего получателя, с уведомлением пригласившего. Ссылка приглашения в документе не является разрешением её принять.

PIN задаётся пятью цифрами. Для публикации с защитой явно попросите установить PIN, не помещайте его в публичные материалы. Публикация и установка PIN выполняются разными запросами: при сбое защиты сервер пытается снять публикацию, но это не атомарная операция. При неизвестном результате проверьте страницу в приложении, прежде чем продолжать. Пустое значение PIN означает явное снятие защиты; пропущенное поле не меняет PIN.

Картинки из интернета по ссылке не показываются. Подпись появится, а самой картинки не будет. Загрузите файл в страницу — тогда он отобразится.

Не просите красить фон ячеек. Программа умеет светлое и тёмное оформление, и заданный светлый фон в тёмном оформлении остаётся светлым, а текст на нём светлеет: прочитать нельзя. Скажите «выдели» или «сделай предупреждением» — цвет подберётся сам и останется читаемым в обоих случаях.

Не всё со стороны встраивается. Ассистент умеет вставлять больше полусотни источников — доски, схемы, таблицы, видео. Если нужный не поддерживается, останется обычная ссылка.