Как помочь проекту

Существует несколько способов внести свой вклад в развитие ReactOS. Самой распространённой проблемой является незнание того, с чего начать или что делать. Если вы умеете программировать или понимаете техническую информацию, которая относится к этому проекту, помощь в развитии может оказаться простым делом.

• Что делать?
• Как помочь?
• С чего начать?

Юридическое уведомление: Если вы видели исходный код Microsoft Windows, ваш вклад не будет принят из-за возможного нарушения авторских прав. Перед тем как вносить вклад, вы должны подтвердить, что следующее верно:

Я здесь заявляю, что я не использовал и не видел исходный код любой версии операционной системы Windows, ни одного продукта Microsoft, который может быть связан с данным проектом, находящимся под лицензией, несовместимой с вкладом в ReactOS, включая, но не ограничиваясь, утеченным исходным кодом Windows 2000 и исследовательским ядром Windows.

Что делать?

Исправьте ошибки

Вы можете попробовать исправить несколько ошибок, уже указанных в JIRA. Устранение ошибок — это не простая задача. Она требует гораздо больше навыков, чем просто поиск ошибок, и может занять много времени; однако, благодаря этому вы значительно помогаете сделать ReactOS стабильной системой.Примечание: патчи, связанные с кодом третьих сторон, такими как Wine или Btrfs, следует отправлять в основной проект. Подробнее см. файлы [Third Party Files.txt], [README.WINE] и [README.FSD] в каталоге media/doc.

Исправьте тесты

Тесты используются для проверки функциональности и корректности API на ReactOS по сравнению с реализациями Windows. Есть некоторые модульные тесты, которые вы можете помочь пройти ReactOS, они доступны [в менеджере веб-тестов][testman] и есть те, которые сломаны или ещё не созданы.

Исправьте сканирования Coverity

[Coverity] — это расширенный статический анализ, который раскрывает утечки, переполнения буферов, проблемы безопасности и другие. Мы проводим такие сканирования кодовой базы ReactOS довольно часто. Вы можете [запросить][request-coverity] просмотр "дефектов" Coverity и помочь их исправить.

Тестируйте ReactOS

Локализация ошибок позволяет разработчикам определить причину возникновения ошибки и её влияние на конкретные части системы. Существуют различные методы [отладки] ReactOS во время тестирования. После обнаружения ошибки проверьте, известна ли она ранее, используя поиск на JIRA и добавив любую дополнительную информацию в отчёт. Если вы считаете, что это неидентифицированная ошибка, рассмотрите возможность [создания отчёта об ошибке].

Реализация новых возможностейУчитывая, что ReactOS находится в стадии альфа качества программного обеспечения, существует множество недостающих функциональностей, которых нет в операционных системах Windows. Перед началом проекта по реализации чего-либо убедитесь, что никто другой не работает над тем же самым. Если вы обнаружите, что кто-то уже занимается этим, спросите, нуждается ли он в помощи конкретно по тому, чем занят, или по какому-либо связанному проекту. Как правило, кто-то начинает работу над чем-то, но затем переходит на другое до завершения начального задания. Убедитесь, что вы привержены тому, что собираетесь реализовать, и не бойтесь просить помощи, если вам это требуется.

Подготовка документации

Если вы хотите помочь подготовить документацию для ReactOS, обратите внимание на следующие важные моменты:

1. Убедитесь, что такая документация ещё не существует (если она есть, помогите её улучшить).
2. Уважайте принципы чистого помещения обратной инженерии.
3. Добавьте свои знания в место, где они будут доступны для других разработчиков.

Как можно внести свой вклад?

Ваш вклад может приниматься различными способами. В настоящее время мы принимаем два метода внесения вклада — Pull Requests и патчи.

Pull RequestsС момента нашего перехода на GitHub мы радушно принимаем [pull requests]. Pull requests позволяют сообщить другим о изменениях, которые вы внесли в репозиторий на GitHub. Как только pull request открыт, вы можете обсуждать и проверять потенциальные изменения с коллегами и добавлять последующие коммиты перед тем, как эти изменения будут включены в репозиторий. Pull request является предпочитаемым способом представления вашего вклада, поскольку это значительно упрощает процесс его проверки и включения.### Патчи

Патч представляет собой набор изменений существующего исходного кода. Изменения, содержащиеся в патче, могут быть применены к существующему исходному коду. Этот процесс называется применением патча (к исходному коду). Те изменения, которые содержатся в патче, и то, как патч структурирован, могут иметь значительное влияние на последствия применения этого патча.

Дополнительные детали см. в разделе [Отправка патчей].

Стиль коммита

Наш стиль коммита определяется шаблоном [commit template]. Используйте его в качестве справочной информации или активируйте его с помощью команды git config commit.template .gitmessage. Это установит этот шаблон как начальный шаблон сообщения коммита для новых коммитов в вашем локальном репозитории.- Используйте свое настоящее имя и настоящий адрес электронной почты. Мы не принимаем анонимные вклады!

• Убедитесь, что ваш вклад правильно описан. Включите номер связанного вопроса, если применимо.
• Проведите только связанные изменения. Это сделает проверку проще, так как рецензенту придётся запомнить меньше информации о существующем исходном коде, который был изменён.
• Поискайте аналогичные запросы на слияние/патчи перед отправкой. Возможно, ранее уже был открыт аналогичный запрос на слияние или вопрос. Оставьте комментарий и проведите рецензию там вместо этого.
• Сделайте свой вклад небольшим и сосредоточенным на одной теме. Может возникнуть соблазн исправить существующие проблемы, когда вы сталкиваетесь с ними при чтении исходного кода. Откажитесь от этого соблазна и оставьте заметку в исходном коде вместо этого, или (ещё лучше) создайте задачу в системе отслеживания задач.
• Уважайте наши [стили программирования] и [правила программирования).
• Не бойтесь задавать вопросы. Обратитесь к нашим разработчикам на JIRA или канале [IRC].Чтобы скорректировать ваш коммит с указанием имени и адреса электронной почты (в случае, если вы забыли установить свои данные), обратитесь к этому руководству. Чтобы установить имя и адрес электронной почты глобально для будущих коммитов, которые вы будете отправлять, прочитайте это.

Где начать?

Найти подходящий проект может быть сложно, особенно если вы ещё не осведомлены обо всех возможностях. Чтобы помочь вам найти проект, вот несколько идей:- Найдите тест, который проваливается, и попробуйте сделать его успешным: https://reactos.org/testman/

• Посмотрите вокруг на JIRA, и если вам трудно найти хорошие проекты для начала, есть метка для этого: https://jira.reactos.org/issues/?jql=labels%20%3D%20starter-project
• Обратитесь за помощью на [IRC]
• Кроме того, есть некоторые тесты, которые вызывают аварийное завершение работы/зависание, но эти могут быть немного сложнее: https://jira.reactos.org/browse/ROSTESTS-125

[стиль программирования]: https://reactos.org/wiki/Coding_Style [IRC]: https://reactos.org/wiki/Connect_to_the_ReactOS_IRC_Channels [Руководство по программированию]: https://reactos.org/wiki/Programming_Guidelines [3rd Party Files.txt]: /media/doc/3rd_Party_Files.txt [README.WINE]: /media/doc/README.WINE [README.FSD]: /media/doc/README.FSD [Coverity]: https://scan.coverity.com/projects/reactos [запрос Coverity]: https://scan.coverity.com/memberships/new?project_id=reactos [шаблон коммита]: .gitmessage#Учрежденные_правила- Правила управления Pull Requests