diff --git a/website/content/en/internal/cross-repo-commits.adoc b/website/content/en/internal/cross-repo-commits.adoc index 1b567f2e8d..99fe0484b9 100644 --- a/website/content/en/internal/cross-repo-commits.adoc +++ b/website/content/en/internal/cross-repo-commits.adoc @@ -1,24 +1,26 @@ --- title: "Cross Repo Commit Policy" sidenav: docs --- +include::shared/en/urls.adoc[] + = Cross Repo Commit Policy This policy provides flexibility for contributors to commit across repositories without heavyweight processes for small, low-impact changes, while ensuring larger changes still undergo normal review and oversight. == Policy Guidelines * *Obvious Fixes:* Anyone may make obvious, small changes (e.g., typo or build break fixes) to any repository, subject to repository-specific rules. * *Repository Rules:* Committers must know, understand, and follow the specific rules and validation tools of the repositories they are modifying. * *Cross-Repository Trust:* When committing outside their primary area, committers are trusted to use their best judgment based on the following framework: ** *Sufficient Review:* The change has received appropriate peer review for its size and complexity. ** *Expert Consultation:* Repository experts are consulted for non-trivial changes. ** *Stricter Rules:* The committer remains deferential to areas requiring formal oversight (e.g., the `ports/Mk` tree). ** *Scale:* The larger or more complex the change, the more critical it is to seek review and wait for explicit approval. ** *When in Doubt:* Seek review from a committer experienced in the target repository before committing. * *Accountability:* Committers must accept feedback on both process and content. If a mistake occurs, the default action is an immediate backout, followed by a more formal review, as appropriate. When in doubt, ask first and seek a sanity check. -See the extref:{committers-guide}[Committer's Guide] for specific blanket grants and commit message conventions. +See the link:{committers-guide}[Committer's Guide] for specific blanket grants and commit message conventions. diff --git a/website/content/en/internal/developer.adoc b/website/content/en/internal/developer.adoc index 1d33380813..91ca48e068 100644 --- a/website/content/en/internal/developer.adoc +++ b/website/content/en/internal/developer.adoc @@ -1,46 +1,46 @@ --- title: "Resources for FreeBSD Committers" sidenav: docs --- include::shared/en/urls.adoc[] = Resources for FreeBSD Committers == link:{committers-guide}[Committers Guide] This document is an overall guide for all new committers, including both technical details and policy details. For the former, see the chapters on link:{committers-guide}#git-primer[the Git VCS], the link:{committers-guide}#bugzilla[Bugzilla] bug tracking system, and the link:{committers-guide}#ssh.guide[SSH Quick-Start Guide]. It contains almost everything a new committer to the FreeBSD Project needs to know. See the Documentation Project Primer and the Porter's Handbook for more info. == link:{fdp-primer}[FreeBSD Documentation Project Primer for New Contributors] Everything you will need to know to start contributing to the Project – from mandatory and recommended software, to the philosophy behind the Project. === link:{fdp-primer}doc-build/#doc-build-rendering-html[Rendering to HTML] Using the Git repository to update and build the pages. == link:{porters-handbook}[FreeBSD Porter's Handbook] A guide for FreeBSD ports contributors and committers. This includes the canonical link:{porters-handbook}versions[Table of `__FreeBSD_version` Values]. == FreeBSD Projects * link:../../docproj/[FreeBSD Documentation Project] * link:../../releng/[FreeBSD Release Engineering] * link:../../platforms/[FreeBSD Hardware Platforms Projects] * link:../../projects/[FreeBSD Development Projects] == Other Resources -* link:../../developers/cvs/[Source Code Repositories] +* link:{committers-guide}#committer.types[Source Code Repositories] * link:../../support/[Bug Reports] * link:../../security/[FreeBSD Security Information] * link:../../copyright/[Copyright] * https://wiki.FreeBSD.org[FreeBSD Wiki] link:..[FreeBSD Internal Home] diff --git a/website/content/ru/internal/_index.adoc b/website/content/ru/internal/_index.adoc index 71721bfe84..10a41dffd6 100644 --- a/website/content/ru/internal/_index.adoc +++ b/website/content/ru/internal/_index.adoc @@ -1,43 +1,43 @@ --- title: "Внутренние страницы FreeBSD" sidenav: docs --- include::shared/authors.adoc[] include::shared/ru/urls.adoc[] = Внутренние страницы FreeBSD На этой странице собраны ссылки на документы, описывающие различные аспекты проекта FreeBSD как такового, если рассматривать его отдельно от исходных текстов системы. == Проекты Существуют различные проекты, которые находятся за пределами основного пути разработки. Ряд групп работают на «переднем крае», чтобы расширить возможности FreeBSD в новых направлениях. Здесь представлен обзор link:{freebsd-releng}[процесса инжиниринга релизов FreeBSD]. А здесь вы найдёте link:../releng/[расписания предстоящих официальных релизов FreeBSD]. == Процедуры -Для того чтобы избежать хаоса в проекте, который распространен по всему миру, необходимы некоторые link:../policies/[формальные процедуры]. +Для того чтобы избежать хаоса в проекте, который распространен по всему миру, необходимы некоторые link:policies[формальные процедуры]. == Люди Персонал проекта FreeBSD состоит из link:../administration[команд, групп и отдельных лиц] с назначенными ролями и зонами ответственности, а также link:{contributors}#staff-committers[разработчиков]. Перейдя по ссылкам, вы найдёте их список, а также объяснения, кто за что отвечает. Здесь вы можете прочитать link:hats[политику ограничения сроков полномочий для назначенных ролей] от Основной Группы (Core Team) и некоторые рекомендации от {imp-name} о том, link:working-with-hats[как работать с ролями]. == Ресурсы Здесь приведён список некоторых link:developer[технических ресурсов для коммиттеров FreeBSD]. Для тех, у кого есть учётные записи в link:machines[основной сети FreeBSD.org], здесь перечислены доступные машинные ресурсы и виды работ, для которых они предназначены. Вы можете узнать больше link:about[о веб-сервере FreeBSD], включая машину, программное обеспечение, зеркалирование веб-страниц FreeBSD. // // The FreeBSD Russian Documentation Project // // Original EN revision (19.08.2021): 8e22e76d94dc5fef83abcb3c082ab4242ef90ba2 // diff --git a/website/content/ru/status/report-2026-04-2026-06/bugmeister.adoc b/website/content/ru/status/report-2026-04-2026-06/bugmeister.adoc index 9d81fb6910..81a2e8ab84 100644 --- a/website/content/ru/status/report-2026-04-2026-06/bugmeister.adoc +++ b/website/content/ru/status/report-2026-04-2026-06/bugmeister.adoc @@ -1,74 +1,74 @@ === Команда Bugmeister Ссылки: + link:https://bugs.freebsd.org/[FreeBSD Bugzilla] URL: link:https://bugs.freebsd.org/[] link:https://bugs.freebsd.org/bugzilla/page.cgi?id=showreport.html&type=total_open_bugs_over_time[Общее количество открытых ошибок во времени] URL: link:https://bugs.freebsd.org/bugzilla/page.cgi?id=showreport.html&type=total_open_bugs_over_time[] Контактное лицо: Bugmeister В этом квартале нам удалось снизить количество сообщений о проблемах (Problem Reports). Хотя мы по-прежнему получаем патчи для дерева исходных кодов (src), большинство получаемых патчей относится к портам. Возможно, это связано с внедрёнными нами настройками автоуведомлений. Для дерева src за последние 180 дней мы получили 643 новых сообщения о проблемах и закрыли 844. Для портов эти цифры составили 3493 и 4375 соответственно. В настоящее время мы не ведём статистику о том, сколько из них действительно приводят к коммитам, хотя мы полагаем, что это число не является незначительным. За тот же 180-дневный период Марк Линимон (Mark Linimon) и Торстен Цюльсдорф (Torsten Zuehlsdorff) продолжали работу по классификации (триажу) старых сообщений о проблемах. Работа Марка частично финансировалась Фондом FreeBSD в 2025 году. Результаты этой работы видны по двум последним спадам на нашем графике link:https://bugs.freebsd.org/bugzilla/page.cgi?id=showreport.html&type=total_open_bugs_over_time[Общее количество открытых ошибок во времени]. -Кроме того, в этом году мы, похоже, привлекаем больше внимания со стороны различных разработчиков FreeBSD (коммитеров). +Кроме того, в этом году мы, похоже, привлекаем больше внимания со стороны различных разработчиков FreeBSD (коммиттеров). Пожалуйста, свяжитесь с mailto:bugmeister@FreeBSD.org[bugmeister], если вы заинтересованы в помощи. Конечно, мы всё ещё лучше справляемся с классификацией сообщений, чем с привлечением внимания к уже имеющимся. Предложения приветствуются. Марк Линимон взял на себя долгосрочный проект по обеспечению применимости всех отправленных патчей. Однако он не претендует на роль специалиста по контролю качества и не может самостоятельно оценивать их пригодность. Общий вывод заключается в том, что благодаря обучению пользователей в этом году мы получаем сообщения о проблемах более высокого качества. В частности, патчи проверяются на применимость в течение одной-двух недель после их поступления и при необходимости исправляются. Однако чем дальше в прошлое мы углубляемся, тем более проблемными становятся сообщения, особенно за 2019 год и ранее. Полагаю, этого следовало ожидать. Марк продолжает работать над ними в фоновом режиме. Текущее количество составляет 2611. Около 427 из них, в основном за 2019 год и ранее, всё ещё требуют дальнейшей доработки. Проблема с настройкой обновления до Bugzilla 5.2 была исправлена. Поверхностное тестирование не выявило значимых регрессий. Выпуск версии с исправлениями 5.2.1 ожидается в ближайшее время. Переход на эту кодовую базу планируется осуществить сразу после её выхода. Изначально это планировалось сделать раньше, однако это казалось нецелесообразным во время подготовки релиза FreeBSD 15.0, а затем было отложено до 15.1. "patchQA.py" всё ещё находится в бета-версии. Код применения патчей не справляется со своей задачей и должен быть заменён. Другая известная проблема с patchQA.py заключается в том, что он не знает происхождения файлов, которые устанавливаются в /etc с помощью installworld. Существуют внешние shell-скрипты, проходящие тестирование, чтобы помочь автоматизировать исправление данных. Это может оказаться проще, чем пытаться писать для этой цели более хрупкий код на Python. Мы создали множество новых учётных записей Bugzilla по запросам пользователей. Количество запросов на создание новых учётных записей увеличилось в этом году. На данный момент в 2026 году их 291, что составляет почти 2 в день. Прошёл уже год с тех пор, как мы начали требовать запросы по электронной почте для создания учётных записей вместо автоматических запросов. Благодаря этому поток спама был снижен практически до нуля. Другая проблема, за которой мы наблюдаем, — огромное количество HTTP-запросов от поисковых роботов (краулеров). На сегодняшний день эти запросы намного превышают количество запросов от реальных пользователей FreeBSD. Они являются причиной внезапных замедлений работы, на которые жалуются наши пользователи. Поскольку никто из нас не является профессиональным системным администратором, мы приветствуем помощь от кого-либо с профессиональным опытом решения таких проблем. Благодарность Александру Зиаи (Alexander Ziaee) и многим другим, кто помог нам достичь текущего состояния. См. также: link:https://wiki.freebsd.org/Bugzilla/SearchQueries[] // // The FreeBSD Russian Documentation Project // // Original EN revision (17.07.2026): 9da80e6c34f34d3421ea3aeb8731b823562cd6aa // diff --git a/website/content/ru/status/report-2026-04-2026-06/rpi-imager.adoc b/website/content/ru/status/report-2026-04-2026-06/rpi-imager.adoc index 6ebfdc1390..ca960d0ed6 100644 --- a/website/content/ru/status/report-2026-04-2026-06/rpi-imager.adoc +++ b/website/content/ru/status/report-2026-04-2026-06/rpi-imager.adoc @@ -1,34 +1,34 @@ [[_raspberry_pi_imager_freebsd_port]] === Порт Raspberry Pi Imager для FreeBSD Ссылки: + link:https://github.com/raspberrypi/rpi-imager[основной репозиторий rpi-imager] URL: https://github.com/raspberrypi/rpi-imager[] + link:https://github.com/raspberrypi/rpi-imager/pull/1655[запрос на включение порта для FreeBSD] URL: https://github.com/raspberrypi/rpi-imager/pull/1655[] + link:https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=296480[PR 296480 - открытое рецензирование порта FreeBSD] URL: https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=296480[] Контакт: Jim Chen Контакт: Nimish Jain Raspberry Pi Imager — это удобный графический инструмент, разработанный Raspberry Pi Foundation, который позволяет пользователям легко настраивать и записывать образы операционных систем на карты памяти для одноплатных компьютеров Raspberry Pi Zero и Raspberry Pi серий 1–5. Наша цель при переносе этого приложения во FreeBSD — продолжать снижать порог входа. Мы хотим, чтобы пользователи, не знакомые с командной строкой, могли легко записывать операционные системы на свои Raspberry Pi. В настоящее время основной проект поддерживает только Linux, MacOS и Windows. Мы создали порт FreeBSD, который использует собственные API ввода-вывода, дисковые и сетевые API и компонуется с предварительно упакованными библиотеками FreeBSD. Основным препятствием для этого проекта в настоящее время является неопределённость в основном репозитории. Сопровождающие запросили поддержку со стороны разработчиков FreeBSD для долгосрочного сопровождения кода, специфичного для FreeBSD. -Если вы являетесь коммитером или участником, заинтересованным в инструментарии для Raspberry Pi во FreeBSD, пожалуйста, сообщите нам об этом или присоединитесь к обсуждению в запросе на включение на GitHub! +Если вы являетесь коммиттером или участником, заинтересованным в инструментарии для Raspberry Pi во FreeBSD, пожалуйста, сообщите нам об этом или присоединитесь к обсуждению в запросе на включение на GitHub! Если эта работа будет принята в основной репозиторий, Makefile для репозитория портов FreeBSD готов к рецензированию как PR 296480 (link:https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=296480[]). Если вы заинтересованы, пожалуйста, попробуйте локальную сборку, клонировав дерево портов и применив патч из указанного выше PR, и сообщите нам, если у вас возникнут какие-либо проблемы! Спонсор: The FreeBSD Foundation // // The FreeBSD Russian Documentation Project // // Original EN revision (22.07.2026): 65329e18c004bbb7da54623532618a10d4bde7d6 // diff --git a/website/content/ru/status/report-2026-04-2026-06/wiki-admin.adoc b/website/content/ru/status/report-2026-04-2026-06/wiki-admin.adoc index 4a897ebccf..7335d86e6b 100644 --- a/website/content/ru/status/report-2026-04-2026-06/wiki-admin.adoc +++ b/website/content/ru/status/report-2026-04-2026-06/wiki-admin.adoc @@ -1,18 +1,18 @@ === Команда Wiki-Admin Ссылки: + link:https://www.freebsd.org/administration/#t-wiki[Участники команды Wiki-Admin] URL: link:https://www.freebsd.org/administration/#t-wiki[] -Марк Линимон (Mark Linimon) отошёл от роли wiki-admin, и два коммитера взяли на себя обязанности wiki-admin. +Марк Линимон (Mark Linimon) отошёл от роли wiki-admin, и два коммиттера взяли на себя обязанности wiki-admin. В краткосрочной перспективе команда будет заниматься запросами на создание учётных записей и т.п. В среднесрочной перспективе планируется помощь в структурировании страниц вики. В долгосрочной перспективе рассматривается идея перехода с MoinMoin Wiki на другое вики-программное обеспечение. // // The FreeBSD Russian Documentation Project // // Original EN revision (30.06.2026): e9e92467b71c8141362786334bd544f0fe986fc9 //