Внесение вклада в jQuery Mobile

Добро пожаловать! Благодарим вас за интерес к внесению вклада в проект jQuery Mobile. Вы почти на месте. Более подробную информацию о том, как внести вклад в этот и все другие проекты jQuery Foundation, можно найти на сайте contribute.jquery.org. Вам обязательно стоит ознакомиться со статьями о внесении вклада кода.

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

Мы находимся в IRC, особенно в #jqueryui-dev, если у вас есть какие-либо вопросы. Если вы никогда раньше не вносили вклад в открытый исходный код, мы составили краткое руководство с советами, хитростями и идеями о том, с чего начать (http://contribute.jquery.org/open-source/).

Вовлечение

Более подробную информацию о проекте, команде jQuery Mobile, наших еженедельных встречах и о том, как стать более вовлечённым, можно найти на странице «О нас» на веб-сайте проекта. На этой странице мы предоставляем конкретную информацию о проекте относительно отчёта об ошибках, предложения новых функций и внесения кода или контента. Пожалуйста, найдите время, чтобы прочитать это, прежде чем открывать тикет или отправлять запрос на вытягивание.

Проблемы

Если вы столкнулись с ошибкой в фреймворке, вы можете сообщить о ней в системе отслеживания проблем здесь, на Github. Вопросы о том, как использовать фреймворк, или проблемы с вашим пользовательским кодом можно публиковать на форуме.

В документации API jQuery Mobile (https://github.com/jquery/api.jquerymobile.com), ThemeRoller (https://github.com/jquery/themeroller.jquerymobile.com) и Download Builder (https://github.com/jquery/jquerymobile.com) есть свои собственные репозитории, где вы можете сообщать о проблемах.

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

При отправке проблемы включите следующее:

1. Описание проблемы.
2. Тестовую страницу (см. ниже).
3. Шаги для воспроизведения.
4. Ожидаемый результат.
5. Фактический результат.
6. Платформы/браузеры (включая версию) и протестированные устройства.
7. Используемые версии jQuery Mobile и ядра jQuery.
8. Другая релевантная информация, например использование Apache Cordova.

В интересах создания читаемых проблем, пожалуйста, включайте фрагменты кода внутри тройных обратных кавычек, соответствующих JavaScript, CSS или HTML, которые вы хотите обсудить. Дополнительную информацию можно получить на вводной странице для GitHub Flavored Markdown (см. Синтаксис выделения).

Тестовая страница

ВАЖНО, чтобы при отправке проблемы вы всегда предоставляли тестовую страницу!

• Почему? — Это гарантирует, что мы смотрим на одно и то же, когда тестируем на наших устройствах, и что мы знаем обо всём коде и разметке, которая используется.

• Что? — Сделайте тестовую страницу максимально простой. Включайте только разметку/код, необходимый для воспроизведения проблемы.

• Как? — Используйте наш шаблон JS Bin (http://jsbin.com/huvoraba/1/edit), который использует последний код из ветки «master». Не заменяйте ссылки на CSS и JavaScript фреймворка: всегда тестируйте с последним кодом!

  • Вы заметите, была ли проблема уже исправлена.

  • Это позволяет нам редактировать ваш код при необходимости.

  • Тестовая страница не исчезнет и не изменится, пока мы рассматриваем проблему.

  • Мы можем протестировать снова после фиксации исправления проблемы. Перейдём в ветку new-feature, где upstream — это удалённый репозиторий git://github.com/jquery/jquery-mobile.git:

    git checkout new-feature git pull --rebase upstream master

    ... здесь вам, возможно, придётся разрешить некоторые конфликты ...

Теперь вы можете отправить изменения в свой форк и создать запрос на включение изменений (pull request). Помните, что создавать новый pull request имеет смысл только в том случае, если вы ещё не отправляли запрос ранее. В противном случае ваш форк покажет расхождение. Если вы новичок в перебазировании, пожалуйста, обратитесь к главе 3.6 книги Pro Git.

Благодарим вас за вклад в проект jQuery Mobile!