Как стать участником и отправить свой код

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

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

Пожалуйста, заполните индивидуальное или корпоративное соглашение о лицензии участника (CLA).

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

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

Вы сотрудник Google?

Если вы сотрудник Google, пожалуйста, попробуйте отправить внутренний вклад вместо запроса на вытягивание GitHub. Если вы не можете отправить запрос внутри компании, PR также является приемлемым вариантом.

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

1. Отправьте проблему с описанием предлагаемого изменения в трекер проблем.
2. Пожалуйста, не смешивайте более одного логического изменения за раз, так как это затрудняет отслеживание истории. Если вы хотите внести изменение, для которого нет соответствующей проблемы в трекере проблем, создайте её.
3. Также координируйте свои действия с членами команды, которые указаны в рассматриваемой проблеме. Это гарантирует, что работа не дублируется, а раннее информирование о вашем плане обычно приводит к более качественным патчам.
4. Если ваше предложение будет принято и вы ещё этого не сделали, подпишите Соглашение о лицензии участника (см. подробности выше).
5. Создайте форк нужного репозитория, разработайте и протестируйте изменения кода.
6. Убедитесь, что ваш код соответствует существующему стилю в образце, в который вы вносите свой вклад.
7. Убедитесь, что у вашего кода есть соответствующий набор модульных тестов, все из которых проходят.
8. Отправьте запрос на вытягивание.

Сообщества Google Test и Google Mock

Сообщество Google Test существует в основном благодаря дискуссионной группе и репозиторию GitHub. Аналогично, сообщество Google Mock существует в первую очередь благодаря собственной дискуссионной группе. Вам определённо рекомендуется внести свой вклад в обсуждение, и вы также можете помочь нам поддерживать эффективность группы на высоком уровне, следуя и продвигая перечисленные здесь рекомендации.

Будьте дружелюбны

Проявление вежливости и уважения к другим — важная часть культуры Google, и мы настоятельно рекомендуем всем, кто участвует в разработке Google Test, присоединиться к нам и не принимать ничего меньшего. Конечно, быть вежливым — это не то же самое, что неконструктивно не соглашаться друг с другом, но это означает, что мы должны уважительно относиться друг к другу, перечисляя 42 технические причины, по которым конкретное предложение может быть не лучшим выбором. Нет причин быть враждебным или пренебрежительным по отношению к кому-либо, кто искренне пытается внести свой вклад в дискуссию.

Конечно, тестирование C++ — серьёзное дело, но и очень весёлое. Давайте продолжим в том же духе. Стремитесь быть одним из самых дружелюбных сообществ во всём открытом исходном коде.

Как всегда, обсуждайте Google Test в официальной дискуссионной группе GoogleTest. Вам не обязательно отправлять код, чтобы зарегистрироваться. Ваше участие само по себе является ценным вкладом.

Стиль

Чтобы сохранить источник последовательным, читаемым, различимым и лёгким для слияния, мы используем довольно жёсткий стиль кодирования, определённый проектом google-styleguide. Все патчи должны соответствовать стилю, изложенному здесь. Используйте .clang-format, чтобы проверить форматирование.

Требования к участникам

Если вы...