Процесс решения задач

Описание процесса решения задач, дискуссии и работы с issues в спэйсе

Правила трекера задач и дискуссий

Все задачи и дискуссии хакспейса ведутся в issues к репозиторию wiki.

Участники могут предлагать другие инструменты в форме issue.

Правила ведения дискуссий

Текст этой Wiki, в том числе правила и принципы, могут меняться всеми с помощью механизма Pull Request (PR). Обсуждение предлагаемых изменений происходит так же в рамках PR.

Текст каждого PR или Issue, а также комментарии в их обсуждении должны быть обосноваными, опираться на принципы и правила b4cksp4ce.

Если issue предполагает решение какого-то вопроса, рекомендуется добавить в текст описания формулировку проблемы и предложение решения. Тогда в случае принятия предложенное решение может быть приведено к исполнению. В issue без предложения решения должно появится решение в ходе дискуссии, иначе его принятие или отклонение не имеет смсысла. Изменения формулировки проблемы или решения, возникшие в ходе дискуссии долны быть отражены в описании к моменту принятия решения.

Правила принятия PR и issues

  1. Обсуждение вопроса считается завершенным, если участники договорились об этом: по завершению обсуждения issue/PR предлагается к закрытию/отклонению.
  2. Когда обсуждение вопроса считается завершенным, устанавливается интервал в 24 часа. Если за это время участники не вернутся к обсуждению, issue/PR закрывается/отклоняется.
  3. Вопросы требующие срочного решения (в силу внешних факторов) завершаются в установленное время.

Команды в 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 часов, то таймер принятия решения устанавливается на разницу времени между созданием задачи и указанным сроком.

Добавление новых страниц

Для добавления новой страницы (например, описания доклада):

  1. зайти в репозиторий
  2. нажать create new file
  3. указать имя файла, внизу выбрать create new branch, указать имя, нажать на propose new file, затем написать в тексте pull-request'а описание вашего предложения, нажать create pull request
  4. Если вам нужно прикрепить файл, его можно добавить в репозиторий (кнопкой upload с указанием вашей ветки или через git), после чего дать на него ссылку вида /имяфайла

Также вы можете воспользоваться стандартным инструментарием git для создания PR.