Логи, которые помогают думать
Хорошая запись объясняет событие, его контекст и следующий шаг. Поток сообщений сам по себе ещё ничего не рассказывает.
Открыть заметкуМеньше шума, больше смысла
Хорошие проекты
Хорошие проекты
начинаются
с внимания
Пишем о том, что помогает цифровым продуктам жить дольше: ясных решениях, понятной документации и маленьких улучшениях каждый день.
Читать заметкиИнженерия · продукт · рабочие привычки
Уважение к деталямПонятные системыСпокойная работа
01 / Библиотека
На полях
разработки
Короткие наблюдения, которые можно забрать в свой следующий проект.
Релиз начинается с плана возврата
Небольшой список проверок перед публикацией экономит больше времени, чем ещё одна срочная правка после неё.
Открыть заметкуДокументация для будущего себя
Записывайте причины решений в тот момент, когда они ещё очевидны. Через месяц эти несколько строк станут полезнее схемы.
Открыть заметку
02 / Подход
Сначала понять
Потом упростить
Когда задача кажется сложной, полезно описать её обычными словами. Кто столкнулся с проблемой? Что человек пытается сделать? По какому признаку мы поймём, что стало лучше?
- НаблюдениеСобрать факты и отделить их от предположений
- Маленький шагПроверить одно изменение с понятным результатом
- ЗаписьСохранить вывод и вернуться к нему позже
03 / Читальный зал
Подробности имеют значение
Логи, которые помогают думать
Начните с вопроса, на который должна отвечать запись. «Не получилось» почти бесполезно; «Не удалось сохранить черновик после повторной попытки» уже задаёт направление поиска. Добавляйте время, название операции и безопасный идентификатор события, чтобы связать сообщения в одну историю.
Не записывайте пароли, токены и содержимое личной переписки. Для повторяющихся событий задайте уровни важности и срок хранения. Полезность журнала лучше проверять на обычном рабочем случае: сможет ли коллега восстановить последовательность без устного объяснения?
Попробуйте сегодня: выберите одну частую ошибку и перепишите её сообщение так, чтобы было понятно, что делать дальше.
Релиз начинается с плана возврата
Перед публикацией зафиксируйте, какое поведение меняется, как его проверить и по какому признаку нужно остановиться. Если изменение затрагивает данные, заранее разберитесь с совместимостью старой версии. Возврат к прежнему коду не всегда возвращает прежнее состояние данных.
После обновления пройдите один реальный сценарий от начала до конца. Проверяйте результат глазами человека, который пользуется продуктом, а затем сверяйте технические сигналы. Сохраните короткую запись: что обновили, что проверили и кто знает о результате.
Попробуйте сегодня: добавьте к описанию ближайшего изменения три строки - проверка, условие остановки, способ возврата.
Документация для будущего себя
Полезный документ начинается с назначения. Опишите, какую задачу решает система, где находятся её границы и кто за неё отвечает. Команды и примеры добавляйте после контекста: без него даже точная инструкция быстро превращается в набор непонятных действий.
Отделяйте подтверждённое состояние от плана. Указывайте дату проверки, оставляйте ссылку на решение и удаляйте утратившие силу шаги. Короткий актуальный текст обычно удобнее большого документа, в котором приходится угадывать действующий вариант.
Попробуйте сегодня: откройте инструкцию, которой давно не пользовались, и проверьте её первый шаг.
О журнале
Место для ясных мыслей
«Модуль» - небольшая библиотека заметок о работе над цифровыми проектами. Нас интересуют аккуратная инженерия и привычки, которые помогают доводить дело до конца. В новостях собираем небольшие изменения, которые пригодились в работе.
Новости
Новости «Модуля»
Рабочие решения, которые прошли путь от черновика до проекта.
Пустые экраны проверили вместе с заполненными
В разбор интерфейсов добавили состояния, где ещё нет данных: пустой список, первый запуск и поиск без результата. На каждом экране оставили понятное действие. Особенно пригодилась проверка поиска: прежняя формулировка не объясняла, стоит ли менять запрос.
Передачу задачи начали с короткой карты проекта
Для нового участника собрали одну страницу со схемой сервиса, местом хранения решений и первым безопасным изменением. Полную документацию оставили по ссылкам. В первой задаче больше не приходится одновременно разбираться в коде и искать владельца каждого компонента.
Время загрузки измерили на обычном телефоне
Мобильную страницу проверили с холодным кешем и ограниченной скоростью соединения. Самую большую задержку давало фоновое изображение, которое почти не было видно на первом экране. Его размер уменьшили, а загрузку второстепенных иллюстраций перенесли ниже.
04 / Диалог
Есть мысль для журнала?
Предложите тему, поделитесь наблюдением или задайте вопрос о заметке.