Участие в проекте Apache Ant

Вы нашли ошибку или считаете, что знаете, как реализовать отличную функцию, которую могли бы использовать все остальные люди? Это замечательно, мы будем рады услышать от вас.

Основной репозиторий кода Ant — это git-репозиторий на сайте Apache, а также имеется зеркало на GitHub.

Существует два способа участия: вы можете создать патч и прикрепить его к задаче в Bugzilla или использовать pull request на GitHub. Мы не планируем использовать задачи на GitHub, поэтому если вы сообщаете о баге, пожалуйста, откройте задачу в Bugzilla.

Перед тем как сообщить о баге, пожалуйста, просмотрите страницу с проблемами: https://ant.apache.org/problems.html.

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

Ветки

Ветка master используется для разработки следующей версии Ant 1.10.x — любые патчи или pull requests должны быть компилируемыми с использованием Java 8.

Ветка 1.9.x используется для разработки следующей версии Ant 1.9.x — любые патчи или pull requests должны быть компилируемыми с использованием Java 5.

Пожалуйста, укажите явно, к какой ветке вы относитесь (1.9.x или 1.10.x) — обычно изменения из 1.9.x портятся в 1.10.x, но не всегда наоборот.

Изменение кода

• Создайте тематическую ветку от той ветки, где вы хотите начать работу (обычно это master или 1.9.x ветка, см. выше).
• Делайте коммиты логических единиц.
• Уважайте стиль исходного кода:
  • Используйте пробелы для отступов.
  • Создавайте минимальные диффы — отключите действия типа "переформатировать исходный код" или "упорядочить импорты". Если вам кажется, что исходный код следует переформатировать, создайте отдельную задачу/PR для этого изменения.
  • Проверьте наличие ненужных пробелов с помощью команды git diff --check перед выполнением коммита.
• Убедитесь, что ваше сообщение к коммиту находится в правильном формате. Ваше сообщение к коммиту должно содержать ключ задачи в Bugzilla, если вы создали её.
• Убедитесь, что вы добавили необходимые тесты для ваших изменений.
• Выполните все тесты с помощью команды ./build.sh clean test, чтобы удостовериться, что ничего больше не было случайно сломано.

Подача изменений

• Подпишите Contributor License Agreement, если ваше изменение действительно маленькое или вы уже подписали один такой договор.
• Если вы хотите создать патч для своей задачи в Bugzilla, используйте команду git format-patch, чтобы создать его (или набор патчей), таким образом мы сможем сохранить информацию об авторстве. Прикрепите патч(и) к задаче.
• В качестве альтернативы отправьте свои изменения в тематическую ветку вашего форка репозитория.
  • Отправьте pull request в репозиторий организации Apache.