Процесс решения задач
Описание процесса решения задач, дискуссии и работы с issues в спэйсе
Правила трекера задач и дискуссий
Все задачи и дискуссии хакспейса ведутся в issues к репозиторию wiki.
Участники могут предлагать другие инструменты в форме issue.
Правила ведения дискуссий
Текст этой Wiki, в том числе правила и принципы, могут меняться всеми с помощью механизма Pull Request (PR). Обсуждение предлагаемых изменений происходит так же в рамках PR.
Текст каждого PR или Issue, а также комментарии в их обсуждении должны быть обосноваными, опираться на принципы и правила b4cksp4ce.
Если issue предполагает решение какого-то вопроса, рекомендуется добавить в текст описания формулировку проблемы и предложение решения. Тогда в случае принятия предложенное решение может быть приведено к исполнению. В issue без предложения решения должно появится решение в ходе дискуссии, иначе его принятие или отклонение не имеет смсысла. Изменения формулировки проблемы или решения, возникшие в ходе дискуссии долны быть отражены в описании к моменту принятия решения.
Правила принятия PR и issues
- Обсуждение вопроса считается завершенным, если участники договорились об этом: по завершению обсуждения issue/PR предлагается к закрытию/отклонению.
- Когда обсуждение вопроса считается завершенным, устанавливается интервал в 24 часа. Если за это время участники не вернутся к обсуждению, issue/PR закрывается/отклоняется.
- Вопросы требующие срочного решения (в силу внешних факторов) завершаются в установленное время.
Команды в PR и issues
Командой называется строка в комментарии к PR или issue, которая начинается с символа /
. Команды используются для автоматизации процессов и разметки метаинформации.
Участники могут отклонить PR или предложение в issue командой /d
(decline).
При одобрении, участники могут принять PR или предложение в issue командой /a
(accept).
Таймер принятия решения запускается в следующих случаях:
- по первой команде
/a
//d
в обсуждении, в PR таймер запускается сразу - при смене последней команды в комментариях (например, если последний комментарий содержал строку с командой
/d
, а затем появился комментарий с командой/a
-- таймер сбрасывается, снова отсчитываются 24 часа, после которых при отсутствии новых комментариев с командами решение считается принятым); - при изменении описания issue или PR;
- при изменении коммитов PR.
По истечению таймера принятия решения решение принимается следующим образом:
- если отсутствуют комментарии, содержащие команды
/a
или/d
, то изменения в PR или предложение в issue считаются принятыми; - при наличии комментариев с командами
/a
или/d
выбирается последний из них по времени изменения, изменения в PR или предложение в issue считаются принятыми, если в выбранном комментарии использована команда/a
, изменения в PR или предложение в issue отклоняются, если в выбранном комментарии использована команда/d
Если есть внешние факторы влияющие на сроки принятия решения или выполнения задачи, то PR или issue нужно указать крайний срок принятия решения, используя команду /deadline datetime
с указанием даты и времени (datetime
) в формате ISO 8601, например, /deadline 2019-10-29T14:40:00+0300
. Если при установке или очередном сбросе таймера принятия решения до наступления срока принятия решения остается менее 24 часов, то таймер принятия решения устанавливается на разницу времени между созданием задачи и указанным сроком.
Добавление новых страниц
Для добавления новой страницы (например, описания доклада):
- зайти в репозиторий
- нажать
create new file
- указать имя файла, внизу выбрать
create new branch
, указать имя, нажать наpropose new file
, затем написать в тексте pull-request'а описание вашего предложения, нажатьcreate pull request
- Если вам нужно прикрепить файл, его можно добавить в репозиторий (кнопкой
upload
с указанием вашей ветки или через git), после чего дать на него ссылку вида /имяфайла
Также вы можете воспользоваться стандартным инструментарием git для создания PR.