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

OSCHINA-MIRROR/emnetsliym-riot

Присоединиться к Gitlife
Откройте для себя и примите участие в публичных проектах с открытым исходным кодом с участием более 10 миллионов разработчиков. Приватные репозитории также полностью бесплатны :)
Присоединиться бесплатно
Клонировать/Скачать
CONTRIBUTING.md 9 КБ
Копировать Редактировать Web IDE Исходные данные Просмотреть построчно История
gitlife-traslator Отправлено 26.11.2024 09:43 5e774d9

Вклад в RIOT

Благодарим вас за интерес к участию в проекте RIOT! Существует множество способов внести свой вклад, и мы ценим их все. Вы можете перейти к основным разделам этого документа по следующим ссылкам:

Если у вас есть вопросы, пожалуйста, напишите сообщение на нашем [форуме], отправьте электронное письмо на адреса users@riot-os.org или devel@riot-os.org, или пообщайтесь в чате #riot-os на IRC или Matrix.

Напоминаем, что от всех участников ожидается соблюдение нашего Кодекса поведения.

Начало работы

Если вы только начинаете работать с RIOT, возможно, вам сначала захочется прочитать нашу [документацию]. Особенно вам могут быть интересны следующие разделы:

Начало работы; — Создание модулей; — Создание приложения.

Отчёты об ошибках и запросы на добавление функций

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

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

Перед тем как подать отчёт об ошибке, проверьте, нет ли уже открытой проблемы. Если нет, подайте новый отчёт об ошибке. Если вы не уверены, является ли что-то ошибкой, всё равно смело подавайте отчёт.

Если вы считаете, что публичное сообщение о вашей ошибке представляет угрозу безопасности для пользователей RIOT, отправьте электронное письмо с описанием ошибки на адрес security@riot-os.org Мы будем признательны, если вы подождёте 6 месяцев, прежде чем сообщать об этом в публичных каналах, чтобы дать нам достаточно времени для выпуска исправления.

Внесение кода

Если вы думаете, что ваша работа должна быть интегрирована в основной репозиторий RIOT, выполните следующие шаги:

  1. Форкните репозиторий git RIOT (если вы ещё этого не сделали).
  2. Создайте ветку для своего вклада.
  3. Убедитесь, что ваш код соответствует [соглашениям о кодировании] RIOTs.
  4. Сделайте коммиты. Обязательно следуйте [соглашениям о коммите] RIOTs.
  5. Отправьте эту ветку в свой форк на GitHub.
  6. Откройте запрос на вытягивание. См. [запросы на вытягивание].
  7. Сопровождающие RIOT установят [метки] и предоставят обратную связь.
  8. Ответьте на эту обратную связь. См. [работа с Git].
  9. Ваш код будет объединён в основную ветку RIOT master, когда пройдёт проверку.

Обязательно прочтите [общие советы] ниже.

Общие советы

Исходя из опыта, следующие рекомендации помогают быстрее получить вклад в программное обеспечение в мастер-ветку RIOT: — Просите помощи! Либо офлайн, либо... Скажите, что ваш PR содержит 3 коммита с комментариями: prefix1: change 1, prefix2: change 2 и prefix3: change 3.

Вместо того чтобы вносить изменения в prefix2 в четвёртом коммите prefix2: change 4, вы можете использовать опцию --fixup:

$ git add /path/of/prefix2
$ git commit --fixup <hash коммита prefix2>

Сжатие коммитов после проверки

Сжатие коммита выполняется с помощью подкоманды rebase программы git в интерактивном режиме:

$ git rebase master -i

Вы можете найти информацию о перебазировании в документации GitHub по перебазированию.

Если вы использовали коммиты для исправления ошибок во время проверки, сжатие коммитов можно выполнить одной командой:

$ git rebase -i --autosquash

Внимание: не сжимайте коммит, пока сопровождающий не попросит вас это сделать.

В противном случае история изменений проверки будет потеряна, а для больших PR сопровождающему будет трудно их отслеживать. Также может случиться так, что вы внесёте регрессию и не сможете восстановить её из предыдущих коммитов.

При возникновении конфликта слияния вы можете либо разрешить его вручную с помощью редактора и использовать

$ git add -p

Чтобы добавить свои изменения или использовать инструмент слияния, такой как meld, чтобы разрешить конфликт слияния.

$ git mergetool

После разрешения конфликта слияния вы можете продолжить перебазирование с помощью

$ git rebase --continue

Как только сжатие будет выполнено, вам придётся принудительно отправить свою ветку, чтобы обновить PR:

$ git push --force-with-lease

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

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

1
https://api.gitlife.ru/oschina-mirror/emnetsliym-riot.git
git@api.gitlife.ru:oschina-mirror/emnetsliym-riot.git
oschina-mirror
emnetsliym-riot
emnetsliym-riot
master