Внесение вклада в Gauge

Вклады в проект Gauge приветствуются и высоко ценятся. Кодирование — это не единственный способ внести свой вклад в Gauge. Есть множество ценных способов помочь продукту и развивающемуся сообществу Gauge.

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

Различные способы внесения вклада

• Вы можете сообщить о проблеме, которую нашли
• Помогите нам тестировать Gauge, добавив новые автоматизированные тесты к существующим
• Помогите новичкам с Gauge на нашем форуме обсуждений
• Внесите свой вклад в наш блог
• Добавьте примеры использования Gauge к нашему набору примеров, чтобы помочь новым пользователям легко начать работу
• Помогите улучшить нашу документацию
• Внесите кодовый вклад в Gauge!

Все репозитории хранятся на GitHub. Ядро Gauge написано на Go, но плагины могут быть написаны на любом популярном языке программирования. Возьмите любой ожидающий исполнения функционал или исправление ошибки, независимо от его размера, затем отправьте нам pull-request. Даже исправление сломанных ссылок — это огромная помощь!

Как начать вносить вкладСуществует множество задач различной сложности во всех репозиториях Gauge. Все задачи, требующие выполнения, отмечены как "Help Needed". Один из простых способов начать — выбрать небольшую ошибку для исправления. Эти задачи отмечены как "Easy Picks".

Также стоит отметить, что:

"Help Needed" -> "Помощь необходима" "Easy Picks" -> "Лёгкие задачи"

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

Ядро Gauge против плагинов

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

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

Сертификат происхождения разработчика (Developer Certificate of Origin, DCO)

Проект Gauge и его плагины используют механизм, известный как Сертификат происхождения разработчика (DCO), популяризованный организацией The Linux Foundation. Сертификат DCO является юридически обязательным заявлением, которое утверждает, что вы являетесь создателем своего вклада, и что вы лицензируете работу под лицензией Apache License Version 2.0. Чтобы указать своё согласие с условиями ДКС (Developer Certificate of Origin), вы должны «подписать» свой вклад, добавив строку с вашим именем и адресом электронной почты в каждое сообщение коммита Git:

Signed-off-by: <имя> <электронная_почта>
```Ваша подпись свидетельствует о том, что вы либо автор вклада, либо имеете право представить его под открытым лицензионным соглашением, используемым Gauge и его плагинами.

Если вы установили свои `user.name` и `user.email` как часть конфигурации Git, вы можете автоматически подписывать свои коммиты с помощью команды `git commit --signoff` или короткого варианта `git commit -s`.

#### Добавление подписи к ранним коммитам

Для подписи последнего коммита с помощью командной строки используйте:

git commit --amend --signoff

Затем выполните force-push для обновления ветки на вашей форке командой:

git push --force-with-lease

Gauge использует [GaugeBot](https://github.com/getgauge/gauge-bot) для проверки наличия подписи во всех запросах на слияние, и это обязательная проверка.

### Разработочная документация

Если вы пытаетесь создать плагины для Gauge или пытаетесь внести свой вклад в основной код Gauge, обратитесь к [Разработочной документации](https://github.com/getgauge/gauge/wiki/Gauge-Technical-Documentation).

## Увеличение версии Gauge

* Обновите значение переменной `CurrentGaugeVersion` в файле `version/version.go`.

Пример:
```diff
// CurrentGaugeVersion представляет текущую версию Gauge
-var CurrentGaugeVersion = &Version{1, 0, 7}
+var CurrentGaugeVersion = &Version{1, 0, 8}