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

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

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

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

  • Если вы являетесь частным лицом, пишущим исходный исходный код, и уверены, что владеете интеллектуальной собственностью, вам необходимо подписать индивидуальное соглашение CLA .

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

Обычно вам нужно отправить CLA только один раз, поэтому, если вы уже отправили его (даже если оно было для другого проекта), вам, вероятно, не нужно делать это снова.

Отправка патча

  1. Обычно лучше начать с открытия новой проблемы, описывающей ошибку или функцию, которую вы собираетесь исправить. Даже если вы думаете, что это относительно незначительно, полезно знать, над чем работают люди. Упомяните в первом выпуске, что вы планируете работать над этой ошибкой или функцией, чтобы ее можно было поручить вам.

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

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

  4. Сделайте все возможное, чтобы иметь правильно сформированные сообщения о фиксации для каждого изменения. Это обеспечивает согласованность во всем проекте и гарантирует, что сообщения о фиксации могут быть правильно отформатированы различными инструментами git.

  5. Наконец, добавьте коммиты в свою вилку и отправьте запрос на включение .