Получить исходный код

Прежде всего, вам понадобится исходный код! Исходный код Aurora доступен на Apache git:

git clone https://gitbox.apache.org/repos/asf/aurora

Прочитайте руководства по стилю

Кодовая база Aurora в основном написана на Java и Python и соответствует руководствам по стилям Twitter Commons для обоих языков.

• Руководство по стилю Java
• Руководство по стилю Python

Найдите себе занятие

В Github есть задачи с пометкой «хороший первый вопрос», которые являются хорошими отправными точками для новых участников Aurora; выберите одну из них и приступайте к работе! Чтобы назначить задачу себе, вы можете присоединиться к обсуждению проблемы и попросить одного из сопровождающих назначить проблему вам, написать нам сообщение на нашем канале Slack или написать нам по электронной почте dev@apache.aurora.org.

Следующим шагом будет подготовка патча, а затем отправка нам запроса на вытягивание через веб-интерфейс Github.

Отправка запроса на вытягивание

Следуйте инструкциям, изложенным в документации Github.

Если возможно, сделайте ссылку на проблему, которую решает этот PR, добавив #, за которым следует номер проблемы, которую он решает.

Если вы не уверены, кого добавить в качестве рецензента, вы можете по умолчанию добавить Стефана Эрба (StephanErb), Маурисио Гараваглиа (mauri) или Ренана Дель Валле (ridv). Они позаботятся о том, чтобы найти подходящего рецензента для патча.

Объединение вашего обзора

Если вы не коммиттер Aurora, один из коммиттеров объединит ваше изменение, как описано ниже. Как правило, последний рецензент, который дал обзору «Отправляй!», будет нести ответственность.

Объединение собственного обзора (коммиттеры)

Отправьте запрос на вытягивание против основной ветки и нажмите на сквош и объедините PR через веб-интерфейс Github.

Объединение чужого обзора

Иногда вам нужно объединить чужой PR. Используйте веб-интерфейс Github, чтобы сделать это, используя стратегию сквоша и слияния.

Примечание для коммиттеров: иногда требуются изменения в сообщении коммита:

1. Убедитесь, что сообщение коммита не превышает 100 символов в строке.
2. Удалите раздел «Тестирование выполнено». Это обычно избыточно (можно увидеть, проверив связанный обзор) или совершенно не имеет отношения к самому коммиту.

Уборка

Ваш патч приземлился, поздравляем! Последнее, что вы захотите сделать перед тем, как перейти к следующему исправлению, — это навести порядок. Вы можете удалить ветку, которая послужила основой для PR, и если PR касается конкретной проблемы Github, эта проблема должна быть закрыта и помечена версией, на которой было исправлено исправление.