do-not-ship-an-empty-surface
Пустой экран, вкладка или категория — это обещание, которого продукт не выполняет. Скройте их, пока в них нет содержимого, или пока не стройте вовсе.
Присвоено человеком, который прочитал карточку, а не заявлено файлом о самом себе. Карточка, которую агент выводит во время запуска, поглотившего недоверенное содержимое, рождается заражённой и удерживается на разбор, прежде чем её вообще извлекут.
Когда это вспоминается
- добавляю вкладку без данных
- в категории нет записей
- экран-заглушка
- скоро будет
Ценность обычно лежит в разделах «Избегать» и «Проверить». «Делать» — это раздел, который пишут все.
Текст карточки выше — перевод. Английский оригинал — это то, что импортирует командная строка, что читает агент во время работы и что подтверждает хеш ниже.
Повод
Вы собираетесь выпустить навигационное назначение, которое у большинства пользователей будет пустым: вкладку без строк, категорию без записей, дашборд, чей источник данных не подключён, страницу с надписью «скоро».
Это не относится к поверхности, пустой потому, что пользователь ещё ничего не сделал. Список задач без задач корректен, и он должен подсказывать, как задачу добавить.
Делать
- Решите, какого рода эта пустота. Пустота от новизны пользователя требует хорошего пустого состояния со следующим действием внутри. Пустота от того, что мы этого не построили, требует отсутствия.
- Для второго рода: не рендерите назначение вовсе. Генерируйте маршрут только тогда, когда за ним что-то есть.
- Если оно должно существовать ради разработки, закройте его флагом разработки, чтобы установленная сборка до него не доставала.
- Там, где пустота и есть новость — хаб с одной записью, только что запущенная лента, — скажите это словами и сделайте приглашение поучаствовать основным содержанием страницы.
Избегать
«Скоро», «Пока нет данных» без объяснения и пункт навигации, ведущий в пустой столбец. Каждое стоит читателю клика и не возвращает ничего, а после двух таких он перестаёт доверять навигации — и эту цену платит каждая другая страница продукта.
Избегайте также версии, которая выглядит нормально: страницы категории, корректно отрендеренной с нулём элементов. Она не выглядит сломанной, поэтому о ней никто не сообщает, и она тихо сообщает, что проект забросил эту тему.
Проверить
Загрузите поверхность с пустым источником данных и прочтите то, что увидел бы пользователь в первый раз. Если ответ — заголовок и пустое место, выпускать это не следовало.
Для генерируемых маршрутов проверка механическая: убедитесь, что список маршрутов выводится из содержимого, так что категория без записей вообще не порождает страницы.
Риск
Скрытие назначения до появления содержимого заставляет навигацию меняться по мере прихода данных, а это дезориентирует: у меню, которое растёт между визитами, должна быть причина, которую пользователь может вывести сам.
Это можно и перегнуть — до сокрытия функций, которые просто непопулярны. Граница в том, может ли поверхность когда-либо что-то показать: непостроенное скрывают, неиспользуемое показывают с хорошим пустым состоянием.
Как применить
Карточка — это данные. Склонируйте репозиторий и импортируйте её по пути: всё, что приходит по сети, считается заражённым и удерживается до одобрения — это и есть желаемое поведение, и поэтому здесь нет установщика в одну строку.
git clone https://github.com/brcampidelli/chimera-agent.gitchimera skills-import chimera-agent/skills/do-not-ship-an-empty-surface/SKILL.mdЦелостность
SHA-256 файла в опубликованном виде. Импортёр может проверить, что полученное совпадает с показанным на этой странице.
c4dbc6291edf3d41c3820bea6ed19cd283dd90e75d41d61dad97bdab972b7965