Appearance
Стандарт иллюстраций
Все скриншоты документации создаются только на официальных демонстрационных сайтах автора Revolution. Магазины клиентов, рабочие заказы, покупатели, контакты и другие клиентские данные использовать запрещено.
Источник списка: официальная страница Revolution. Публичный вход в демо-админку указан автором: demo / demo.
Разрешённые демо
| Демо | Адрес | Для каких примеров подходит |
|---|---|---|
| Универсальный | universam.oc-mod.ru | админка, базовая структура Revolution |
| Климат | climat.oc-mod.ru | категории, товарные блоки, каталог |
| Запчасти для мобильных | mobile.oc-mod.ru | плотный каталог и характеристики |
| Универсам | market.oc-mod.ru | продуктовый каталог и навигация |
| Кроссовки | shoes.oc-mod.ru | опции, изображения, визуальный каталог |
| Техника Apple | apple.oc-mod.ru | минималистичная витрина и карточка товара |
| Запчасти для авто | zap.oc-mod.ru | сложная каталогизация |
| Автотовары | auto.oc-mod.ru | фильтры и товарные представления |
| Одежда | moda.oc-mod.ru | опции, размеры и изображения |
| Пицца | pizza.oc-mod.ru | корзина и быстрый заказ |
| Косметика | persona.oc-mod.ru | историческая версия 3.1.2; только для явно помеченных примеров |
Обязательные требования к снимку
- Viewport — не меньше 1920×1080.
- Снимается официальный демо-сайт или его демо-админка.
- Вместо рамок используются контрастные красные стрелки с номерами шагов.
- Стрелки показывают полный маршрут пользователя по экрану в порядке
1 → 2 → 3(при необходимости шагов может быть больше). - Первая стрелка указывает вход в нужный раздел настроек, следующая — нужную вкладку или подраздел, последняя — поле, кнопку либо переключатель, с которым нужно работать.
- Под изображением показывается только источник. Разрешение, дата, версия и координаты хранятся в служебном манифесте.
- В кадре должно быть достаточно окружения, чтобы пользователь видел все шаги и понимал расположение элементов.
- Изображение открывается по клику в lightbox с оригинальным разрешением.
- Технические выводы подтверждаются исходниками нужной версии, а не только внешним видом демо.
DOC рассчитан на пользователя без знания интерфейса
Иллюстрация должна буквально показывать, куда нажать сначала, куда перейти затем и где выполнить действие. Один указатель только на конечное поле недостаточен.
Версионность
Публичные демо автора могут обновляться не одновременно с архивом, по которому составлена документация. Поэтому снимок подтверждает расположение и внешний вид элемента, но не заменяет DEV-спецификацию. Отличающаяся версия обязательно указывается в подписи.
Хранение и именование
Файлы размещаются по схеме:
text
/images/official-demo/{section}/{component}-{viewport}.pngДля каждого изображения фиксируются:
- URL официального демо;
- дата съёмки;
- viewport;
- видимая версия Revolution;
- координаты, номера, направления и подписи всех стрелок;
- страница документации, которая использует изображение.
Запрещено
- брать изображения с клиентских или рабочих сайтов;
- публиковать заказы, покупателей, адреса, телефоны и другие персональные данные;
- растягивать снимок низкого разрешения до десктопного размера;
- выделять большие области рамками вместо пошаговых стрелок;
- показывать только конечное поле без пути к нему по интерфейсу;
- вставлять скриншот без нумерации порядка действий;
- выдавать интерфейс старой демо-версии за доказательство поведения Revolution 5.x.