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

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

Мы не используем метки (labels).

Участники могут предлагать другие инструменты в форме 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).

Таймер принятия решения запускается в следующих случаях:

По истечению таймера принятия решения решение принимается следующим образом:

Если есть внешние факторы влияющие на сроки принятия решения или выполнения задачи, то 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.

Creative Commons License
This work is licensed under a Creative Commons Attribution 4.0 International License.