Как внести свой вклад

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

Обратите внимание, что Calendula лицензируется в соответствии с условиями GNU General Public License, версия 3, поэтому, отправляя контент в репозиторий Calendula, вы выпускаете свою работу на условиях этой лицензии.

Поскольку этот репозиторий содержит код для приложения Android, опубликованного в Google Play, которое может включать часть ваших вкладов в будущих обновлениях, мы обязаны иметь соглашения (CLA) со всеми, кто принимает участие. Это самый простой способ дать нам разрешение использовать ваши вклады (по сути, вы предоставляете нам лицензию, но вы по-прежнему являетесь владельцем авторских прав, поэтому сохраняете право изменять свой код и использовать его в других проектах).

Начало работы

Убедитесь, что у вас есть учётная запись GitHub и вы подписали наше Лицензионное соглашение участника. Как только это будет готово, вы можете:

• Отправить проблему, чтобы предложить улучшения или сообщить об ошибках. Убедитесь, что нет другой проблемы с той же темой!

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

• Форкнуть репозиторий, внести некоторые изменения, а затем отправить запрос на вытягивание. Пожалуйста, ознакомьтесь с Внесение изменений для этого.

Внесение изменений

Мы следуем модели ветвления, предложенной Винсентом Дриссеном в этой статье, поэтому у нас есть две основные ветви: master и develop.

• Ветвь master отражает код последней версии приложения, доступной в Google Play.
• Ветвь develop отражает код последних доставленных изменений разработки для следующего выпуска.
• Кроме того, когда версия разработки (почти) отражает желаемое состояние нового выпуска, создаётся ветка релиза. Ветки релизов обычно развёртываются через канал BETA Google Play, прежде чем они станут доступны всем.

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

Я хотел бы внести свой вклад, но я не разработчик...

Вклады без кода также приветствуются! Вы можете многое сделать:

• Прокомментировать проблему или начать свою собственную, чтобы предложить идеи или высказать своё мнение.
• Исправить опечатки, комментарии или уточнить язык, чтобы улучшить качество приложения.
• Предложить значок, лучший рисунок для определённого действия или даже новый логотип приложения из материала ;-).
• Станьте членом сообщества тестирования, присоединившись к группе тестирования в Google Groups. Вы будете автоматически получать обновления из канала BETA, как обычные обновления из Google Play. Это помогает нам находить ошибки перед публичным выпуском!

Присоединяйтесь к каналу BETA: нажмите здесь!

Помощь с переводами приложения

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

Или вы можете внести переводы через запрос на вытягивание:

• Добавьте новую папку с именем values-{LANG}/ в Calendula/src/main/res/.
• Переведите файл strings_translatable.xml из Calendula/src/main/res/values на нужный вам язык.
• Отправьте запрос на вытягивание в ветку translations.

Вы также можете улучшить перевод.