SetFork Docs

Совместная работа

Форки, звёзды, правки, задачи, подписки и соавторы.

Форки

Форк копирует публичный список в ваш аккаунт с видимой пометкой «форкнуто из». Дальше форк развивается сам по себе — его версии принадлежат вам. Форкайте, когда хотите свой вариант; предлагайте правку, когда хотите улучшить оригинал.

Предложения

Любой может открыть предложение к публичному списку: изменить, добавить или удалить блоки с пояснением. Страница предложения устроена как pull request и разбита на вкладки:

  • Обсуждение — треды по предложению;
  • Предлагаемые изменения — дифф со счётчиком изменённых пунктов;
  • Проверки — условия, блокирующие принятие;
  • Итог — каким станет список, если предложение принять: готовый вид глазами читателя (не дифф), подписанный «станет vN+1»;
  • Коммиты — только у предложений из ветки.

Принятое предложение становится новой версией списка с указанием авторства.

Комментарии к пункту

В диффе можно «Прокомментировать пункт» — комментарий привязывается к конкретному блоку и полю (заголовок, описание, команда…), а если выделить текст — к самой цитате. При правках якорь честно показывает состояние: «привязка восстановлена» или «процитированный текст исчез». Отправить комментарий можно сразу («Отправить») или отложить в ревью («Добавить в ревью» — черновик виден только вам, пока не отправите ревью целиком). Тред можно пометить «Решено» / «Вернуть» или перенести в задачу.

В комментарий можно вложить готовый текст поля кнопкой «Предложить текст» — тот, у кого есть право правки, нажмёт «Применить», и текст заменит поле.

Вердикт ревью«Одобрить» или «Запросить изменения»; запрошенные изменения блокируют принятие, пока их не снимут.

Ветки и слияние

Предложение можно вести в ветке. В панели версий переключатель «Ветки» создаёт ветку («Новая ветка…»«Создать») от текущей; на ветке список показывается черновиком и версии не создаются. Когда в ветке есть изменения, кнопка «Открыть pull request» заводит из неё предложение (или отправьте ветку через git — Доступ по git).

Слить такое предложение можно кнопкой «Влить в main» (или «Влить одним коммитом»); если ветка отстала — «Обновить из main» подтянет изменения, а конфликты решаются встроенным резолвером. Обычное предложение (без ветки) владелец просто принимает или отклоняет.

Задачи

У каждого списка есть трекер задач (включается владельцем): нумерованные задачи (#1, #2…) со статусом открыта / закрыта, комментариями и эмодзи-реакциями. Задачи — про «сделать или починить»: проблемы и идеи, ещё не оформленные в правку.

  • Метки — встроенный набор (баг, улучшение, вопрос, документация, нужна помощь, не будет, битая ссылка) плюс свои метки списка с цветом.
  • Вехи — группируют задачи под цель со сроком и показывают прогресс.
  • Исполнители — назначает владелец или соавтор. Если назначить мастера-эксперта, он берётся за задачу сам.

Обсуждения

Отдельный от задач раздел (тоже включается владельцем) — свободные треды на уровне списка, чтобы поговорить, а не «сделать». У обсуждения есть категория (Общее, Идеи, Вопросы, Витрина), заголовок и markdown-тело, дальше — ответы. Статусов, меток и исполнителей у обсуждений нет. (Комментарии к конкретному пункту — это про правки и живут внутри предложения, см. выше.)

Звёзды и папки звёзд

Звёзды — это и закладки, и сигнал популярности. Отмеченные звездой списки можно раскладывать по папкам (как GitHub Lists) на странице со звёздами.

Подписки и уведомления

Следите за списком (с выбором уровня) и подписывайтесь на людей, чтобы видеть их активность в своей ленте; уведомления приходят в меню-колокольчик, а по желанию — на почту и push в браузере. Подробно — в разделе Уведомления и подписки.

Соавторы

Владелец может пригласить соавторов с правом записи: они могут править список и отправлять в него изменения через git, минуя правки.

Панель здоровья списков

На странице «Мои списки» каждый ваш список подсвечен светофором: красный — требует внимания (открытые правки и задачи, битые ссылки, найденные садовником), жёлтый — есть активность (свежие форки, звёзды, обсуждения), зелёный — всё спокойно. Сортировка «что болит сейчас» помогает вести десятки списков и не терять из виду те, что ждут действий.

На этой странице