**Pixman**

Pixman — это библиотека, предоставляющая функции низкоуровневого манипулирования пикселями, такие как компоновка изображений и растеризация трапеций.

Вопросы следует направлять в список рассылки Pixman:

    https://lists.freedesktop.org/mailman/listinfo/pixman

Вы также можете сообщать об ошибках по адресу:

    https://gitlab.freedesktop.org/pixman/pixman/-/issues/new

или отправлять улучшения в виде запроса на слияние через:

    https://gitlab.freedesktop.org/pixman/pixman/-/merge_requests

Для обсуждения Pixman в реальном времени присоединяйтесь к каналам IRC #cairo и #xorg-devel в сети FreeNode IRC.

**Вклад**

Чтобы внести свой вклад в проект Pixman, вам потребуется знание системы контроля версий git. Для быстрого ознакомления есть руководство «Everyday Git With 20 Commands Or So» с веб-сайта Git:

    https://www.kernel.org/pub/software/scm/git/docs/everyday.html

Более подробную документацию по git можно найти на странице документации сообщества Git:

    https://git-scm.com/documentation

Pixman использует инфраструктуру из зонтичного проекта freedesktop.org. Инструкции по использованию службы git на freedesktop.org см. здесь:

    https://www.freedesktop.org/wiki/Infrastructure/git/Developers

Главный репозиторий Pixman находится по адресу:

    https://gitlab.freedesktop.org/pixman/pixman

**Отправка исправлений**

Исправления следует отправлять в виде запросов на слияние через Gitlab.

Сначала вам нужно создать форк основного репозитория Pixman по ссылке:

    https://gitlab.freedesktop.org/pixman/pixman

с помощью кнопки Fork в правом верхнем углу. После этого вы можете добавить свой личный репозиторий в качестве удалённого к своей локальной рабочей копии Pixman git:

    git remote add my-gitlab git@gitlab.freedesktop.org:YOURUSERNAME/pixman.git

    git fetch my-gitlab

Убедитесь, что добавили ключи ssh в свой профиль gitlab по ссылке:

    https://gitlab.freedesktop.org/profile/keys

После настройки общий рабочий процесс отправки исправлений заключается в создании новой локальной ветки с вашими улучшениями и последующем её переносе в ваш личный форк Pixman:

    git checkout -b fix-some-bug
    ...
    git push my-gitlab

Команда `git push` выдаст ссылку, которая позволит вам создать запрос на слияние с официальным репозиторием Pixman.

Каждый раз, когда вы вносите изменения в свою ветку (добавляете новые коммиты или исправляете существующие), отправляйте их обратно в свой личный форк Pixman:

    git push -f my-gitlab

Если есть открытый запрос на слияние, Gitlab автоматически подберёт изменения из вашей ветки, и разработчики Pixman смогут рассмотреть их заново.

Чтобы ваши исправления были приняты, пожалуйста, соблюдайте следующие рекомендации:
* На каждом этапе серия изменений должна компилироваться, а набор тестов должен проходить успешно. Исключение составляет случай, если вы изменяете набор тестов для демонстрации ошибки. В этом случае сделайте один коммит, который приводит к сбою набора тестов из-за ошибки, а затем ещё один коммит, исправляющий ошибку. Вы можете запустить набор тестов с помощью команды:
meson test -C builddir
Это займёт около двух минут на современном ПК.
* Следуйте стилю кодирования, описанному в файле CODING_STYLE.
* Для исправлений ошибок включите обновление набора тестов, чтобы убедиться, что ошибка не появится снова.
* Для новых функций добавьте тесты функции в набор тестов. Также добавьте программу, демонстрирующую новую функцию, в каталог demos/.
* Пишите информативные сообщения о коммитах. Полезная информация для включения:
    * результаты бенчмарков до и после;
    * описание исправленной ошибки;
    * подробное обоснование любого нового API;
    * альтернативные подходы, которые были отклонены (и почему они не работают);
    * если комментарии рецензента были включены, краткая версия истории изменений, описывающая эти изменения.
* Для больших серий исправлений напишите вводный пост с общим описанием серии исправлений, включая результаты бенчмарков и мотивацию. Каждое сообщение о коммите должно быть информативным и содержать достаточно информации для понимания. Почему был необходим именно этот коммит.

В Pixman высокие стандарты качества кода, поэтому почти все могут ожидать, что первые версии их патчей будут отклонены.

Если вы считаете, что рецензенты в чём-то неправы или что приведённые выше рекомендации ошибочны, не стесняйтесь обсудить проблему. Цель рекомендаций и проверки кода — обеспечить высокое качество кода; это не упражнение на соответствие требованиям.