Хотите внести свой вклад? Отлично!

Сначала прочитайте эту страницу (включая примечания мелким шрифтом в конце).

Прежде чем вносить свой вклад

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

Проверка кода

Все отправки, включая отправки участников проекта, требуют проверки. Для этой цели мы используем Gerrit.

Настройка

Если вы ещё этого не сделали на этом компьютере, вам нужно будет установить пароль для Gerrit. Войдите в систему с помощью учётной записи Google, посетите эту ссылку и нажмите ссылку «Сгенерировать пароль» в правом верхнем углу. Вам также потребуется подготовить свою кассу для добавления Change-Ids при фиксации. Выполните:

curl -Lo .git/hooks/commit-msg https://boringssl-review.googlesource.com/tools/hooks/commit-msg
chmod u+x .git/hooks/commit-msg

Загрузка изменений

Чтобы загрузить изменение, отправьте его в специальную цель refs/for/master:

git push origin HEAD:refs/for/master

На выходе вы получите ссылку на изменение. Добавьте agl@google.com и davidben@google.com в качестве рецензентов.

Отправка фиксации с тем же Change-Id, что и существующее изменение, загрузит новую версию (используйте команды git rebase или git commit --amend).

Более подробные инструкции см. в Руководстве пользователя Gerrit.

Примечания мелким шрифтом

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