Вклад в проект

Вы можете внести свой вклад в развитие этого проекта разными способами.

Внести свой вклад может любой желающий, но только члены команды могут объединять запросы на вытягивание (pull requests) или добавлять метки к задачам.

Здесь мы описываем, как различные процессы вклада реализуются на практике для этого проекта. Цель состоит в том, чтобы сделать эти процессы прозрачными, чтобы каждый мог понять, как участвовать.

Если у вас есть предложения по улучшению этих процессов, пожалуйста, предложите их (см. «Запрос на улучшение» ниже)!

Отчёт об ошибке

Если вы используете это программное обеспечение и столкнулись с неожиданным поведением, возможно, вы обнаружили ошибку! Чтобы её исправить, сначала создайте задачу, которая должна содержать:

• Ожидаемое поведение;
• Фактическое поведение (здесь могут помочь скриншоты);
• Как кто-то другой может воспроизвести его (версия программного обеспечения, а также ваш браузер и ОС могут помочь).

Как только вы создадите эту задачу, кто-нибудь с правами на фиксацию должен прийти и попытаться воспроизвести проблему локально и прокомментировать, если он сможет это сделать. Если он сможет, то добавит метку type:Bug. Если нет, то он добавит метку status: Needs info и будет ждать информации от вас.

Будем надеяться, что тогда какой-нибудь хороший человек придёт, чтобы исправить вашу ошибку! Скорее всего, это будет кто-то, кто уже работает над проектом, но это может быть кто угодно.

Они исправят ошибку локально, затем отправят эти изменения в свою вилку. Затем они сделают запрос на вытягивание, и в описании скажут: «Это исправляет ошибку №xxx».

Кто-то из тех, кто поддерживает репозиторий, рассмотрит это изменение, и это может привести к ещё большему обсуждению реализации.

Наконец, как только хотя бы один человек с правами фиксации будет доволен изменением и не будет никаких возражений, они объединят его.

Запрос на улучшение

Возможно, текущее поведение не является неправильным, но у вас всё ещё есть идея, как его можно улучшить.

Процесс будет похож на открытие ошибки, но процесс может занять больше времени, поскольку мы все работаем вместе, чтобы договориться о том, какое поведение следует добавить. Поэтому, когда вы открываете задачу, полезно дать некоторый контекст того, чего вы пытаетесь достичь, почему это важно, где текущая функциональность недостаточна, и любые идеи, которые у вас есть о том, как её можно улучшить.

Эти задачи должны получить метку type:Enhancement. Если решение кажется достаточно очевидным и вы думаете, что другие согласятся, то любой может реализовать решение и предложить его в запросе на вытягивание.

Однако, если задача многогранна или имеет много разных хороших вариантов, скорее всего, потребуется некоторое обсуждение. В этом случае сопровождающий должен добавить метку status:Needs Discussion. Затем будет некоторый период времени, в течение которого все, кто заинтересован в этой задаче или имеет идеи о том, как решить её, должны работать вместе, чтобы прийти к согласованному решению.

Как только появится некоторый консенсус относительно того, как двигаться дальше, кто-то может приступить к реализации изменений.