Что включить в заметку
Начните с объекта и времени: какая публичная страница или блок рассматривались и когда. Затем передайте точный текст сообщения. Если текста нет, опишите видимое состояние своими словами, явно обозначив, что это описание, а не дословная цитата.
Отдельно сформулируйте ожидание. Фразы «список пуст» и «ожидал увидеть список» отвечают на разные вопросы. Первая сообщает наблюдение, вторая — представление пользователя. Когда они разделены, читателю проще понять, какие данные ещё отсутствуют.
Скриншот и лишние сведения
Изображение экрана может содержать адрес электронной почты, идентификаторы и секретные параметры ссылок. Они часто не нужны для обсуждения публичного интерфейса. Перед публикацией сохраняют только необходимую область и проверяют, не раскрыты ли личные сведения в соседних блоках.
Пароль и код подтверждения не входят в описание визуального состояния. Steam отдельно предупреждает против передачи паролей другим людям. Независимый справочник также не нуждается в доступе к аккаунту, чтобы объяснить разницу между сообщением, наблюдением и предполагаемой причиной.
Ограничения воспроизведения
Если состояние наблюдалось один раз, это стоит указать. Нельзя описывать единичный случай как постоянный сбой без повторных данных. Также нельзя гарантировать другим людям тот же результат: у них могут отличаться условия, версия страницы и момент наблюдения.
Удобная итоговая запись содержит факт, контекст и неизвестное. Например: «публичный список не показал строки; время указано; причина неизвестна». Она короче эмоционального рассказа и полезнее для дальнейшей проверки, поскольку не смешивает наблюдение с неподтверждённым обвинением.