Списки и блоки
Модель данных SetFork — типы списков, блоки, шаги, прогоны, связи и экспорт.
Порядок элементов
- Упорядоченная последовательность — порядок шагов важен (1..N): ранбуки для деплоя, рецепты, маршруты, дорожные карты обучения, рейтинги.
- Набор — порядок не важен: списки вещей в дорогу, чек-листы ревью, подборки.
Порядок выбирается при создании и меняется в настройках списка.
Это не то же самое, что тип списка (пошагово, список вещей, чеклист, критерии, варианты, рецепт) — тип отвечает на вопрос, чем является элемент, и от него зависят форма и проверки. Подробности — в разделе Стандарт списка.
Адреса
Каждый список живёт под своим владельцем, как на GitHub:
https://setfork.com/{owner}/{slug}Slug уникален в пределах владельца. Списки бывают публичные (видны всем) и приватные (только владельцу); переключение видимости — в опасной зоне настроек списка.
Блоки
Список собирается из блоков. Основной блок — шаг, но не единственный: радиальная кнопка «+» в редакторе добавляет любой из восьми типов.
| Блок | Для чего |
|---|---|
| 👣 Шаг | Основная единица: действие с командой, подзадачами и обоснованием |
| 📝 Текст | Свободный markdown — введение, пояснение, примечание между шагами |
| 🖼️ Картинка | Иллюстрация или hero-изображение |
| 📊 Опрос | Голосование читателей с вариантами и (по желанию) дедлайном |
| 🎬 Видео | Ролик по ссылке (YouTube/Vimeo) или файлом |
| 🎓 Тест | Вопрос с проверкой: выбор, текст, число, пропуски, пары, порядок, код |
| 📎 Файл | Вложение (PDF, документ, архив — до 25 МБ) |
| 🛒 Товары | Подборка вариантов ярусами — для списков покупок и сравнений |
Шаг подробнее
Шаг — это больше, чем строка текста:
- Заголовок — короткий и в повелительном наклонении («Сделать бэкап базы»).
- Описание — полезные детали: количества, температуры, флаги.
- Команда — одна команда для терминала, выводится с кнопкой копирования.
- Подзадачи — отмечаемые подпункты; в прогонах каждый можно отметить отдельно.
- Уровень —
required(по умолчанию),recommendedилиoptional, как MUST / SHOULD / MAY в RFC. - Почему — обоснование для неочевидных шагов.
- Секция — заголовок группы, который визуально разбивает длинные списки («День 1», «Тесто», «Неделя 3»).
- Ссылки — подписанные ссылки на документацию и источники.
Прогоны
Прогон — исполняемый экземпляр списка, привязанный к конкретной версии. Запустите прогон — и получите живой чек-лист: состояния шагов (todo / current / done / blocked), заметки к каждому шагу и отметки подзадач. Прогоны переживают новые версии списка — они остаются на той версии, с которой начались. Сколько раз список проходят и доходят ли до конца — видно на странице Инсайты.
Теги
Любой публичный список несёт до восьми тегов — по ним работают поиск и подборки, у каждого тега есть своя страница. Подробнее о поиске, тегах и коллекциях — в разделе Поиск и дискавери.
Связи между списками
В описании и шагах можно сослаться на другой список вики-ссылкой
[[handle/slug]] — она превращается в живую ссылку. На странице списка
автоматически появляется блок «На этот список ссылаются» (обратные ссылки),
так что связи видны с обеих сторон. Форки при этом хранят собственную
родословную («форкнуто из»).
Экспорт
Любой список можно скачать в Markdown или HTML либо напечатать в PDF (шаги никогда не разрываются между страницами).