1 files changed, 118 insertions, 0 deletions
diff --git a/documentation/content/ru/articles/port-mentor-guidelines/_index.adoc b/documentation/content/ru/articles/port-mentor-guidelines/_index.adoc
new file mode 100644
index 0000000000..bc304f10bc
--- /dev/null
+++ b/documentation/content/ru/articles/port-mentor-guidelines/_index.adoc
@@ -0,0 +1,118 @@
+---
+copyright: '2011 Thomas Abthorpe, Chris Rees'
+description: 'Руководство для наставников портов FreeBSD'
+organizations:
+  - 
+    organization: 'The FreeBSD Ports Management Team'
+tags: ["port", "mentor", "mentee", "guidelines", "FreeBSD"]
+title: 'Руководство для наставников портов'
+---
+
+= Руководство для наставников портов
+:doctype: article
+:toc: macro
+:toclevels: 1
+:icons: font
+:sectnums:
+:sectnumlevels: 6
+:source-highlighter: rouge
+:experimental:
+:images-path: articles/port-mentor-guidelines/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+:imagesdir: ../../../images/{images-path}
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+
+'''
+
+toc::[]
+
+[[port-mentor.guidelines]]
+== Рекомендации по взаимоотношениям наставника и подопечного
+
+Этот раздел предназначен для того, чтобы помочь развеять таинственность процесса наставничества, а также открыто способствовать конструктивному обсуждению для адаптации и развития руководящих принципов. В нашей жизни слишком много правил; мы не государственная организация, навязывающая регулирование, а скорее коллектив единомышленников, работающих для достижения общей цели — поддержания гарантии качества продукта, который мы называем Деревом Портов.
+
+[[why.mentor]]
+=== Почему наставник (mentor)?
+
+* У большинства из нас были наставники, и это наставничество в Проекте было важным и полезным, поэтому верните эти усилия, предложив стать наставником для кого-то другого.
+* У вас есть непреодолимое желание делиться знаниями с другими.
+* В наказание за это вы обрекаете себя на добровольную каторгу коммитить хорошую работу, сделанную другими!
+
+[[mentor.comentor]]
+=== Наставник/Сонаставник
+
+Причины для совместного наставничества:
+
+* Значительная разница во времени. Доступные, интерактивные наставники, доступные через IM, крайне полезны!
+* Потенциальный языковой барьер. Да, FreeBSD, как и большинство разработок программного обеспечения, ориентирована на английский язык, однако наличие наставника, говорящего на родном языке, может быть очень полезным.
+* ВРЕМЕНИ НЕТ! Пока в сутках не станет 30 часов, а в неделе — 8 дней, у некоторых из нас просто не хватает времени. Разделение нагрузки с кем-то другим облегчит задачу.
+* Наставник для новичков может получить пользу от опыта старшего коммиттера/наставника.
+* Две головы лучше, чем одна.
+
+Причины индивидуального наставничества:
+
+* Вы не играете по правилам с другими.
+* Вы предпочитаете иметь индивидуальные отношения.
+* Причины для совместного наставничества к вам не относятся.
+
+[[mentor.expectations]]
+=== Ожидания
+
+Мы ожидаем, что наставники будут проверять и тестировать все предлагаемые исправления, по крайней мере, в течение начального периода, длящегося более одной или двух недель.
+
+Мы ожидаем, что наставники должны нести ответственность за действия своих подопечных. Наставник должен отслеживать все коммиты, сделанные подопечным, как одобренные, так и неявные.
+
+Мы ожидаем, что наставники убедятся, что их подопечные прочитали extref:{porters-handbook}[Руководство портировщика], extref:{pr-guidelines}[руководство по обработке PR] и extref:{committers-guide}[Руководство коммиттера]. Хотя и не обязательно запоминать все детали, каждый коммиттер должен иметь общее представление об этих вещах, чтобы быть эффективной частью сообщества (и избежать как можно больше ошибок новичка).
+
+[[mentees]]
+=== Выбор подопечного
+
+Не существует определённого правила, по которому кандидат считается готовым; это может быть комбинация количества поданных PR, количества поддерживаемых портов, частоты обновлений портов и/или уровня участия в определённой области интересов, такой как GNOME, KDE, Gecko или других.
+
+Кандидат должен практически не допускать тайм-aутов, оперативно реагировать на запросы и в целом оказывать помощь в поддержке своих портов.
+
+Должна быть история вовлечённости, так как общеизвестно, что обучение коммиттера требует времени и усилий. Длительное участие в проекте и наблюдение за процессами предполагают накопление знаний. Слишком часто мы видели, как сопровождающий отправляет несколько PR, появляется в IRC и спрашивает, когда ему дадут право на коммит.
+
+Подписка и активное участие в почтовых рассылках очень полезны. Нет прямой связи и ожидания быстрого результата, что отправка сообщений в списки рассылок сделает кого-то коммиттером, но это демонстрирует вовлечённость. Некоторые письма позволяют оценить знания кандидата, а также его взаимодействие с другими. Аналогично, участие в IRC может повысить заметность человека.
+
+Спросите у шести разных коммиттеров, сколько PR должен отправить сопровождающий перед тем, как его номинируют, и вы получите шесть разных ответов. Спросите у тех же людей, как долго кто-то должен участвовать, и та же дилемма. Сколько портов у него должно быть как минимум? Теперь у нас есть повод для бесконечных споров! Некоторые вещи просто трудно измерить, наставнику придется полагаться на свое лучшее суждение и надеяться, что portmgr согласится.
+
+[[mentorship.duration]]
+=== Продолжительность наставничества
+
+По мере развития и укрепления уровня доверия, подопечному могут быть предоставлены «неявные» права на внесение изменений. Это может включать тривиальные изменения в [.filename]#Makefile#, [.filename]#pkg-descr# и т. д. Аналогично, это может включать обновления `PORTVERSION`, которые не требуют изменений в `plist`. Другие обстоятельства могут быть определены на усмотрение Наставника. Однако в период наставничества изменения версии порта, затрагивающие зависимые порты, должны проверяться наставником.
+
+Как и все мы разные личности, у каждого подопечного свои кривые обучения, временные обязательства и другие влияющие факторы, которые будут влиять на время, необходимое перед тем, как они смогут «летать самостоятельно». Эмпирически, за подопечным следует наблюдать как минимум 3 месяца. 90-100 коммитов — это ещё один ориентир, который может использовать наставник перед тем, как отпустить подопечного. Другие факторы, которые следует учитывать перед освобождением подопечного, — это количество ошибок, которые они могли совершить, полученные QAT и т.д. Если они всё ещё делают ошибки новичка, им всё ещё требуется руководство наставника.
+
+[[mentor.comentor.debate]]
+=== Дискуссия о роли наставника/сонаставника
+
+Когда запрос поступает в portmgr, он обычно звучит так: «Я предлагаю «foo» для права коммита в порты, я буду со-наставником вместе с «bar»». Предложение получено, проголосовано и принято.
+
+Наставник является основным контактным лицом или "первым среди равных", а сонаставник — его заместитель.
+
+Один "ответственный" участник, чьё имя мы опустим, сделал https://lists.freebsd.org/pipermail/cvs-ports/2007-September/134614.html[первый зарегистрированный коммит с сонаставником]. Подобные коммиты с со-менторами также были замечены в дереве src. Делает ли это их правильными? Делает ли это их неправильными? Похоже, это часть эволюции того, как всё устроено.
+
+[[mentee.expectations]]
+=== Ожидания
+
+Мы ожидаем, что подопечные будут готовы к конструктивной критике от сообщества. Здесь еще много "преданий" и традиций, неписанных правил. Умение правильно реагировать на конструктивную критику — это то, на что мы обращаем внимание в первую очередь, оценивая вклад подопечных в IRC и в почтовых рассылках.
+
+Мы предупреждаем подопечных, что часть критики может быть менее "конструктивной", чем остальная (будь то из-за проблем с языком общения или излишней придирчивости), и что умение достойно принимать такую критику — это часть участия в большом сообществе. В случае конкретных проблем с определёнными людьми или любых вопросов мы надеемся, что они обратятся к членам portmgr в IRC или по электронной почте.