Совместная работа
Форки, звёзды, правки, задачи, подписки и соавторы.
Форки
Форк копирует публичный список в ваш аккаунт с видимой пометкой «форкнуто из». Дальше форк развивается сам по себе — его версии принадлежат вам. Форкайте, когда хотите свой вариант; предлагайте правку, когда хотите улучшить оригинал.
Предложения
Любой может открыть предложение к публичному списку: изменить, добавить или удалить блоки с пояснением. Страница предложения устроена как pull request и разбита на вкладки:
- Обсуждение — треды по предложению;
- Предлагаемые изменения — дифф со счётчиком изменённых пунктов;
- Проверки — условия, блокирующие принятие;
- Итог — каким станет список, если предложение принять: готовый вид глазами читателя (не дифф), подписанный «станет vN+1»;
- Коммиты — только у предложений из ветки.
Принятое предложение становится новой версией списка с указанием авторства.
Комментарии к пункту
В диффе можно «Прокомментировать пункт» — комментарий привязывается к конкретному блоку и полю (заголовок, описание, команда…), а если выделить текст — к самой цитате. При правках якорь честно показывает состояние: «привязка восстановлена» или «процитированный текст исчез». Отправить комментарий можно сразу («Отправить») или отложить в ревью («Добавить в ревью» — черновик виден только вам, пока не отправите ревью целиком). Тред можно пометить «Решено» / «Вернуть» или перенести в задачу.
В комментарий можно вложить готовый текст поля кнопкой «Предложить текст» — тот, у кого есть право правки, нажмёт «Применить», и текст заменит поле.
Вердикт ревью — «Одобрить» или «Запросить изменения»; запрошенные изменения блокируют принятие, пока их не снимут.
Ветки и слияние
Предложение можно вести в ветке. В панели версий переключатель «Ветки» создаёт ветку («Новая ветка…» → «Создать») от текущей; на ветке список показывается черновиком и версии не создаются. Когда в ветке есть изменения, кнопка «Открыть pull request» заводит из неё предложение (или отправьте ветку через git — Доступ по git).
Слить такое предложение можно кнопкой «Влить в main» (или «Влить одним коммитом»); если ветка отстала — «Обновить из main» подтянет изменения, а конфликты решаются встроенным резолвером. Обычное предложение (без ветки) владелец просто принимает или отклоняет.
Задачи
У каждого списка есть трекер задач (включается владельцем): нумерованные задачи
(#1, #2…) со статусом открыта / закрыта, комментариями и эмодзи-реакциями.
Задачи — про «сделать или починить»: проблемы и идеи, ещё не оформленные в правку.
- Метки — встроенный набор (баг, улучшение, вопрос, документация, нужна помощь, не будет, битая ссылка) плюс свои метки списка с цветом.
- Вехи — группируют задачи под цель со сроком и показывают прогресс.
- Исполнители — назначает владелец или соавтор. Если назначить мастера-эксперта, он берётся за задачу сам.
Обсуждения
Отдельный от задач раздел (тоже включается владельцем) — свободные треды на уровне списка, чтобы поговорить, а не «сделать». У обсуждения есть категория (Общее, Идеи, Вопросы, Витрина), заголовок и markdown-тело, дальше — ответы. Статусов, меток и исполнителей у обсуждений нет. (Комментарии к конкретному пункту — это про правки и живут внутри предложения, см. выше.)
Звёзды и папки звёзд
Звёзды — это и закладки, и сигнал популярности. Отмеченные звездой списки можно раскладывать по папкам (как GitHub Lists) на странице со звёздами.
Подписки и уведомления
Следите за списком (с выбором уровня) и подписывайтесь на людей, чтобы видеть их активность в своей ленте; уведомления приходят в меню-колокольчик, а по желанию — на почту и push в браузере. Подробно — в разделе Уведомления и подписки.
Соавторы
Владелец может пригласить соавторов с правом записи: они могут править список и отправлять в него изменения через git, минуя правки.
Панель здоровья списков
На странице «Мои списки» каждый ваш список подсвечен светофором: красный — требует внимания (открытые правки и задачи, битые ссылки, найденные садовником), жёлтый — есть активность (свежие форки, звёзды, обсуждения), зелёный — всё спокойно. Сортировка «что болит сейчас» помогает вести десятки списков и не терять из виду те, что ждут действий.