Благодарим вас за интерес к участию в проекте RIOT! Существует множество способов внести свой вклад, и мы ценим их все. Вы можете перейти к основным разделам этого документа по следующим ссылкам:
Если у вас есть вопросы, пожалуйста, напишите сообщение на нашем [форуме], отправьте электронное письмо на адреса users@riot-os.org или devel@riot-os.org, или пообщайтесь в чате #riot-os
на IRC или Matrix.
Напоминаем, что от всех участников ожидается соблюдение нашего Кодекса поведения.
Если вы только начинаете работать с RIOT, возможно, вам сначала захочется прочитать нашу [документацию]. Особенно вам могут быть интересны следующие разделы:
— Начало работы; — Создание модулей; — Создание приложения.
Приветствуются как отчёты об ошибках, так и запросы на добавление функций, большие и маленькие.
Прежде чем отправлять запрос на добавление функции, проверьте, не существует ли уже открытая проблема. Если нет, отправьте запрос на добавление функции. Опишите свой вариант использования, почему вам нужна эта функция и почему она важна для RIOT.
Перед тем как подать отчёт об ошибке, проверьте, нет ли уже открытой проблемы. Если нет, подайте новый отчёт об ошибке. Если вы не уверены, является ли что-то ошибкой, всё равно смело подавайте отчёт.
Если вы считаете, что публичное сообщение о вашей ошибке представляет угрозу безопасности для пользователей RIOT, отправьте электронное письмо с описанием ошибки на адрес security@riot-os.org Мы будем признательны, если вы подождёте 6 месяцев, прежде чем сообщать об этом в публичных каналах, чтобы дать нам достаточно времени для выпуска исправления.
Если вы думаете, что ваша работа должна быть интегрирована в основной репозиторий RIOT, выполните следующие шаги:
Обязательно прочтите [общие советы] ниже.
Исходя из опыта, следующие рекомендации помогают быстрее получить вклад в программное обеспечение в мастер-ветку 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 )