Вклад в libGDX

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

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

Использование системы отслеживания проблем

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

• Пожалуйста, не используйте систему отслеживания проблем для личных запросов поддержки (используйте форум или IRC). См. также Получение помощи.

• Пожалуйста, не отвлекайте или не троллите проблемы. Поддерживайте обсуждение по теме и уважайте мнения других.

Отчёты об ошибках

Ошибка — это демонстрируемая проблема, вызванная кодом в репозитории. Хорошие отчёты об ошибках чрезвычайно полезны — спасибо!

Рекомендации для отчётов об ошибках:

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

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

См. Получение помощи для получения дополнительной информации и примера.

Запросы функций

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

Запросы на вытягивание

Внести вклад в libGDX легко:

• Форкните libGDX на http://github.com/libgdx/libgdx
• Узнайте, как работать с исходным кодом
• Поработайте и отправьте запрос на вытягивание на GitHub!

Изменения и дополнения API

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

Если хотите посоветоваться с другими разработчиками, либо отправьте запрос на вытягивание и начните разговор на Github, либо начните новую тему в этом подфоруме. Вам потребуются специальные разрешения форума, напишите электронное письмо на адрес contact@badlogicgames.com и сообщите мне свой идентификатор форума. Также необходимо подписаться на этот форум по электронной почте, внизу страницы есть кнопка. Вы также можете зайти на IRC (irc.freenode.org, #libgdx), где скрывается большинство основных разработчиков.

Лицензионное соглашение участника

Libgdx лицензируется под лицензией Apache 2.0. Прежде чем мы сможем принять вклады кода, нам нужно, чтобы вы подписали наше лицензионное соглашение участника. Просто распечатайте его, заполните пробелы и отправьте копию на contact@badlogicgames.com, с темой [Libgdx].