Apollo распространяется под лицензией Apache 2.0, которая не накладывает ограничений, и использует стандартный процесс разработки на GitHub, используя GitHub трекер для отслеживания проблем и слияния пулл-запросов в ветку master. Если вы хотите внести даже небольшой вклад, не стесняйтесь, но следуйте указаниям ниже.
Перед тем как мы примем нестандартный патч или пулл-запрос, нам потребуется ваша подпись под Соглашением о лицензии для вкладчиков. Подписание соглашения не предоставляет вам прав на коммиты в основной репозиторий, но это означает, что мы можем принять ваш вклад, и вы получите авторское упоминание, если мы это сделаем. Активные вкладчики могут быть приглашены в ядро команды и предоставлены права на слияние пулл-запросов.
Наши конвенции кодирования соответствуют Google Java Style Guide.
Мы предоставляем шаблонные файлы intellij-java-google-style.xml для IntelliJ IDEA и eclipse-java-google-style.xml для Eclipse. Если вы используете другие IDE, вы можете настроить их вручную, ссылаясь на шаблонные файлы.* Убедитесь, что все новые файлы .java имеют простой Javadoc-комментарий класса с хотя бы тегом @author
, идентифицирующим вас, и желательно хотя бы абзацом о том, для чего предназначен класс.* Добавьте себя как @author в .java файлы, которые вы substantially изменили (более чем косметические изменения).
Добавьте некоторые Javadocs и, если вы изменили пространство имен, некоторые элементы документирования XSD.
Для новой функции или важного исправления ошибки следует добавить несколько юнит-тестов.
Если никто другой не использует вашу ветку, пожалуйста, перезапустите её против текущей master (или другой целевой ветки в основном проекте).
Обычно, мы бы свели коммиты для одной функции в один коммит. Есть 2 способа сделать это:
Чтобы перезапустить и свести на основе удалённой ветки
git rebase -i <remote>/master
fixup
, и т.д.Создайте новую ветку и слейте эти коммиты в один
git checkout -b <some-branch-name> <remote>/master
git merge --squash <current-feature-branch>
При написании сообщения коммита следует придерживаться следующих конвенций: если вы исправляете существующую проблему, добавьте Fixes #XXX в конце сообщения коммита (где XXX — номер проблемы).
Вы можете оставить комментарий после Вход в систему
Неприемлемый контент может быть отображен здесь и не будет показан на странице. Вы можете проверить и изменить его с помощью соответствующей функции редактирования.
Если вы подтверждаете, что содержание не содержит непристойной лексики/перенаправления на рекламу/насилия/вульгарной порнографии/нарушений/пиратства/ложного/незначительного или незаконного контента, связанного с национальными законами и предписаниями, вы можете нажать «Отправить» для подачи апелляции, и мы обработаем ее как можно скорее.
Опубликовать ( 0 )