1 В избранное 0 Ответвления 0

OSCHINA-MIRROR/pcloud-lucas-apollo-consul

Клонировать/Скачать
CONTRIBUTING.md 4.2 КБ
Копировать Редактировать Web IDE Исходные данные Просмотреть построчно История
Отправлено 06.06.2025 08:20 2d8022c

Внесение вклада в Apollo

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 способа сделать это:

    1. Чтобы перезапустить и свести на основе удалённой ветки

      • git rebase -i <remote>/master
      • объединить коммиты через fixup, и т.д.
    2. Создайте новую ветку и слейте эти коммиты в один

      • git checkout -b <some-branch-name> <remote>/master
      • git merge --squash <current-feature-branch>
  • При написании сообщения коммита следует придерживаться следующих конвенций: если вы исправляете существующую проблему, добавьте Fixes #XXX в конце сообщения коммита (где XXX — номер проблемы).

Опубликовать ( 0 )

Вы можете оставить комментарий после Вход в систему

1
https://api.gitlife.ru/oschina-mirror/pcloud-lucas-apollo-consul.git
git@api.gitlife.ru:oschina-mirror/pcloud-lucas-apollo-consul.git
oschina-mirror
pcloud-lucas-apollo-consul
pcloud-lucas-apollo-consul
master