Разработка#

Angie — проект с открытым исходным кодом, поучаствовать в котором могут все.

Исходный код#

Клонировать исходный код Angie можно из наших открытых репозиториев: Mercurial, Git.

Стиль кода#

Вносимые изменения должны сочетаться с остальным кодом Angie; хорошей отправной точкой будет руководство для nginx. При этом учитывайте, что у нас есть заметные отличия, особенно в коде API.

Совет

При сомнениях посмотрите на окружающий код и следуйте его примеру либо запустите grep по базе кода в поисках вдохновения.

Коммит-сообщения#

Исторически коммит-лог ведется на английском языке.

Сообщение начинается с однострочной сводки о проделанной работе. Она может иметь префикс, уже использованный в коммит-логе для этой части кода. Сводка имеет длину до 67 символов включительно; за ней может следовать пустая строка, после которой идут подробности.

В хорошем сообщении указаны причины изменения, что было сделано, и каково положение дел сейчас:

API: bad things removed, good things added.

As explained elsewhere[1], the original API was bad because stuff;
this change was introduced to improve that aspect locally.

Levels of goodness have been implemented to mitigate the badness;
this is now the preferred way to work.  Also, the badness is gone.

[1] https://example.com

Детали, которые могли остаться незамеченными:

  • Резюме кончается точкой и начинается с прописной (большой) буквы.

  • Если использован префикс, то за ним следует строчная (маленькая) буква.

  • Предложения в одной строке разделяются двойным пробелом.

Финальные проверки#

  • Проверьте, что ваши изменения работают на всех целевых платформах.

  • Запустите тесты на всех платформах, чтобы устранить возможность регрессии:

    $ cd tests
    $ prove .
    

    Подробности см. в файле tests/README.

  • Убедитесь, что вас устраивают юридические условия.

Куда отправлять патчи#

Сейчас мы не можем напрямую принимать коммиты в свои репозитории, поэтому создайте PR-запрос на нашем зеркале на GitHub.

С вопросами и предложениями обращайтесь к разработчикам через GitHub Issues.