Phabricator/Help/uk

Шановний користувачу Фабрикатора! Якщо у Вас є запитання, просто поставте їх на сторінці обговорення. Ми покращимо нашу документацію на основі отриманих відгуків. If you want to test Phabricator, You should use the Labs instance.

Щоб отримати вищий рівень розуміння Фабрикатора, перейдіть за посиланням нижче. Або продовжіть читати цю сторінку, щоб почати прямо вже.

Що таке Фабрикатор і що він робить?

Створення свого облікового запису



 * Спершу переконайтеся, що Ви Вікімедіа.
 * Якщо у Вас ще нема вікімедійної обліковки,.
 * Перейдіть на сторінку входу в Фабрикатор (коли Ви не в системі, посилання відображається як стрілка на двері у верхньому правому кутку).
 * Натисніть на кнопку із соняшником, де пише «Login or Register - MediaWiki».
 * MediaWiki.org попросить у Вас підтвердження з'єднання.
 * Фабрикатор попросить Вас ввести ім'я користувача. Якщо сумніваєтеся, просто використайте вікімедійне ім'я користувача, але зауважте, що ім'я користувача в Фабрикаторі не може містити символи не латинкою, як-то العَرَبِيةُ чи 中华民族. Також вимагається вказати адресу електронної пошти, але вона не буде видима іншим користувачам.
 * If you find your Phabricator account disabled, please add a note on Talk:Phabricator/Help. If you do not receive timely feedback, contact the Bugwrangler.
 * Натисніть на Manage у навігаційній панелі зліва.
 * Натисніть на Edit Profile і вкажіть про себе Also Known As (наприклад, своє повне ім'я), щоб Вас було легше шукати.


 * Розширені
 * Якщо у Вас є обліковий запис wikitech.wikimedia.org &mdash; також відомий як обліковка LDAP або Gerrit — Ви можете також скористатися ним. Одне й те ж ім'я користувача Фабрикатора може бути приєднане і до MediaWiki.org, і до LDAP. Це може бути запасним варіантом, якщо раптом станеться неправдоподібне і SUL Вікімедіа не працюватиме. Приєднайте свої облікові записи SUL та LDAP до одного імені користувача Фабрикатора! Інакше Ви створите у Фабрикаторі два різні облікові записи.
 * Ми не заохочуємо використання багатофакторної автентифікації у Фабрикаторі Вікімедіа. Якщо все ж Ви плануєте її використовувати, прочитайте спершу настанови і вимоги до багатофакторної автентифікації.

Повернення попередніх облікових записів Bugzilla та RT
Перейдіть за цим посиланням.

Отримання оновлень і сповіщень
Фабрикатор сповіщує Вас про відповідну активність, включно з Вашими власними діями. Ви можете відрегулювати налаштування електронної пошти на свій смак і отримувати веб-сповіщення лише для певної діяльності або не отримувати їх взагалі.

Фабрикатор надає кілька інструментів отримання сповіщень, які Ви хочете отримувати.

Ви також можете визначити у своїх налаштуваннях електронної пошти, для яких окремих дій (напр., змін статусу, власника, пріоритету чи підписників) у завданні Ви б хотіли (не) отримувати сповіщень. Продуктивні користувачі, вірогідно, захочуть зменшити налаштування пошти до мінімуму, як на File:Phabricator email settings panel.png Як член проекту, ви можете відписатися від пошти по проекту через  на сторінці проекту "Members" Більше інформації у посібнику користувача Керування Е-поштою Фабрикатора
 * Якщо Вам цікавий окремий об'єкт (завдання, макет тощо), просто клікніть  на його сторінці. Додавання коментаря підпише Вас автоматично.
 * Якщо Вас цікавить уся діяльність в межах проекту, Ви можете натиснути на  на сторінці огляду проекту. There is more information in the Projects user guide under "Watching Projects".

Створення правил Herald для сповіщень
Перейдіть за цим посиланням, щоб дізнатися, як створити власні (особисті) правила сповіщення у Herald'і Фабрикатора Вікімедіа. Це більш розширена можливість, і її може бути складно використовувати.

Створення завдання
Є три способи створити завдання, залежно від інформації, яку треба внести: Fill the form, leaving the fields you are not sure about unchanged.
 * Просто нове завдання: натиснути на кнопку  або посилання Create Task угорі справа. Ви побачите пусту форму.
 * A subtask of an existing task: click the Create Subtask link located in the right column of the current task. The dependency between both tasks will be set, and some values of the parent task will be carried by default (Assigned To, Subscribers, Priority, Projects). Subtasks will be listed in the parent task under "Task Graph", sorted by most recently updated.
 * A similar task to the one you just created: after creating a task, a Similar Task link is offered at the top right corner. Click it to prefill Assigned To, Subscribers, Priority, and Projects with the same values.

Форматування
Фабрикатор підтримує деяке форматування у текстових полях. [https://secure.phabricator.com/book/phabricator/article/remarkup/ Див. цю довідку про форматування у Фабрикаторі.]

Обирання проектів
In order to relate a task with a project (tag) that uses Phabricator, you just need to start typing its name in the Tags field and select the project from the list of matching projects (the list will only show five matching projects). You can also search for projects by clicking the magnifier icon in the Tags field. You can add one or more projects to the Tags field. If you are unsure, you can also leave it empty — triagers will take care of tasks that have no project set. There is a (long) list of projects available. Press  to search for projects. (This list is also available at Phabricator/Projects.)

Вказання пріоритету завдання
Зазвичай пріоритет вказують менеджери продуктів, обслуговувачі або розробники, що планують працювати над завданням, або баґмайстери чи досвідчені члени спільноти, але не та ж людина, що подає звіт про помилку чи сторонній спостерігач. Див. детальніше Менеджмент проектів у Фабрикаторі.

Використання e-mail
Ви також можете створювати завдання, надсилаючи електронні листи на [mailto:task@phabricator.wikimedia.org task@phabricator.wikimedia.org]. Тема листа має бути назвою завдання, тіло буде використане, як воно є, а прикріплення будуть додані до завдання. Щоб встановити проект, додайте відповідну команду «!projects» та його хештеґ на початку тіла, наприклад,. Further commands to set the task assignee, priority or status via email are available.

''Примітка: якщо Ваш підпис в електронному листі не форматується відповідно до де-факто стандартів (тобто з «-- », що відділяє його від тіла тексту), його також буде включено. Бажано виключити приватну інформацію з підпису, коли будете пробувати це перший раз, просто щоб бути певними.''

Вказання певних значень в URL створення завдання
Посилання «Повідомити в Фабрикаторі про баґ» може містити численні значення у вигляді параметрів URL, прописаних після загального посилання на створення завдання.

Це дуже просунута функція. Дізнайтеся більше тут.

Написання коментарів та описів
Фабрикатор дозволяє дописувати і редагувати коментарі й описи, використовуючи форматування тексту та вставку зображень чи інших файлів; див. Завантаження файлів-прикріплень. Ви можете скористатися панеллю інструментів угорі поля вводу тексту і можете використати у Фабрикаторі Remarkup. Укінці сторінки у Вас є живий попередній перегляд, щоб перевірити, чи текст виглядає так, як Ви очікуєте. До популярної розмітки належить:
 * Згадування користувачів у вигляді  створить посилання на їхній профіль і підпише їх до завдання.
 * Додавання номера завдання у вигляд  створить посилання на завдання включно зі спливною карткою.   вставить назву завдання у Ваш текст.
 * Додавання назви проекту у вигляді  створить посилання на головну сторінку проекту.
 * Якщо Ви хочете цитувати текст, можна просто додати " " на початку. Якщо хочете відповісти на коментар, включивши його як цитату, натисніть на випадну стрілку у правому кінці коментаря, на який відповідаєте.
 * Якщо Ви хочете відобразити завантажений файл-макет, наприклад, зображення, вбудованим у Ваш коментар, впишіть.
 * Якщо хочете створити зовнішнє посилання, наприклад,  у вікірозмітці, скористайтеся   включно з пробілами у Фабрикаторі.
 * Якщо Ви хочете додати веб-адресу (URL-посилання) у коментарі, щоб, наприклад, вказати на тестовий випадок, рекомендовано скопіювати і вставити посилання з адресного рядка Вашого браузера, наприклад,  замість  . Інтервікі-префікси на зразок   у Фабрикаторі не підтримуються і більшість колишніх налаштувань Баґзілли теж ні, наприклад, зміни Gerrit теж треба вставляти як повні веб-адреси.
 * Якщо хочете вставити рядки коду, додайте рядок з трьома косими штрихами до і після коду: . Або створіть Paste і посилання на Paste із завдання.

Зверніть увагу, що мова розмітки Фабрикатора відрізняється від розмітки MediaWiki. Поточна версія Фабрикатора містить Remarkup Reference про його власну розмітку.

Завантаження файлів-прикріплень
Є декілька способів завантажувати файли: Ви можете додати файл (наприклад, знімок екрану) у коментар або опис завдання, перетягнувши його туди мишкою. Користувачі також можуть копіювати і вставляти зображення через буфер обміну своєї системи.

Якщо у Вашій системі це неможливо, можете скористатися phabricator:file/upload і послатися на номер файлу (наприклад, «123»), який відобразиться після успішного завантаження файлу, вписавши  у коментар. Це створить посилання на файл. Щоб включити файл у коментар, візьміть ID файлу у фігурні дужки:. Per default it's included as thumbnail. Більше опцій форматування у довідці Remarkup. If you have to upload files frequently and consider the currently available options uncomfortable, you could also add a text panel to your homepage with a direct link.

Досвідчені користувачі також можуть використовувати «аркове завантаження», яке дає номер F, який можна використати через синтаксис  для вбудування в коментар.

Зверніть увагу, що Ви не можете завантажити файл, а потім обмежити рівень доступу до нього (наприклад, прив'язавши його тікета про загрозу безпеки). Вам доведеться вилучити файл і завантажити його повторно з більш обмеженими дозволами доступу. Рекомендовано завантажувати файли, які матимуть обмежений доступ, разом зі створенням тікету з обмеженим доступом  (про загрозу безпеки).

Якщо Вам знадобиться вилучити файл, який Ви завантажили, відкрийте огляд file/, оберіть «Authored», тоді виберіть файл і натисніть «Delete File» на бічній панелі.

Менеджмент проектів у Фабрикаторі
Якщо Ви підтримуєте чи керуєте проектом, будь ласка, перейдіть за цим посиланням по детальнішу інформацію.

Parent tasks and subtasks
Tasks can be a parent task or a subtask of any number of other tasks. Such relations can be set via "Edit Related Tasks...". This feature can be used to accomplish a few different things:

Parent tasks and subtasks are displayed under "Task Graph" in the task. NOTE: There is a "Edit Related Tasks... > Create Subtask" feature. In addition to setting up the correct parent/subtask relationship, it also caries the CC (subscription) list into the new subtask.
 * Blockers and Subtasks. A (parent) task might simply be blocked by another (sub)task, representing a dependency (see Phabricator/Project management on how to add a subtask).
 * Tracking. A "workless" (parent) task blocked by several (sub)tasks might be tracking a collection of (sub)tasks within a release or other time period (see #"Tracking" Tasks below).
 * Схвалення. Декілька завдань (наприклад, чернетки командних цілей) можуть бути блоковані єдиним завданням, яке показує, що чернеткові завдання схвалено, після чого чернетки цілей стають реальними цілями.

Визначення пріоритетності
Кожне завдання має поле «Priority», яке відображається кольором завдань на бічній панелі робочої панелі. Зверніть увагу, що ця пріоритетність спадкова для завдання, тому буде однаковою у кожному проекті і робочій панелі, де завдання з'являється.

На робочій панелі, завдання можна впорядкувати у колонці за пріоритетністю. Оберіть сортування «Natural» і перетягуйте завдання униз чи вгору колонки. Це дозволяє сортувати впорядковані відставання за пріоритетом або позначати терміновість елементів у колонці «Needs Review». Зверніть увагу, що колонки робочої панелі також можна сортувати за полем пріоритету унизу, тож коли обговорюєте робочу панель з кимось, хто не є в кімнаті, краще домовитися і використовувати той же порядок сортування, щоб уникнути непорозумінь.

Призначення
Кожне завдання можна приписати одній людині. Як і пріоритет, це для завдання спадкове і впливає на кожен проект, до якого завдання належить. Тому неможливо, щоб завдання було приписане Робіну в одному проекті і Кім — в іншому. Приписана особа відображається у картці завдання на кожній робочій панелі.

Деякі команди можуть вибрати приписувати завдання людям, коли завдання у колонці TODO. Інші можуть залишити людям самим приписуватися до завдань вже тоді, коли завдання переносяться з TODO у DOING. Приписування завдання собі до того, як Ви готові над ним працювати — це бути собакою на сіні.

Після того, як головна робота над завданням завершена, є два головні способи приписування:


 * Завдання залишається приписаним тому, хто робив роботу, як постійному власнику завдання
 * Завдання переписується на того, хто має продовжувати роботу над ним

Так, наприклад, після того, як код написано, може бути необхідною вичитка коду конкретною людиною. У другому випадку, завдання буде переписане на ту людину, і буде зрозуміло, хто відповідальний за завдання надалі. Очевидно, що якщо є кілька вірогідних кандидатів на вичитування коду, ця модель не спрацює. Пізніше, якщо завдання чекає на когось, хто буде код тестувати, або впроваджувати, або робити щось іще важливе для завершення завдання (наприклад, переіндексування), його треба приписати цій людині. Команда може мати правило, що завершені завдання мають бути приписані назад тій людині, яка їх створила, так щоб вона могла підтвердити, що потреби було задоволено і завдання можна закривати.

«Зроблено»
Кожне завдання має поле «Status», у якому статус можна вказати як «Resolved». Вирішені завдання за замовчуванням приховуються з робочої панелі, а коли відображаються, то показуються сірими і викресленими. Інші можливі статуси — «Open» (відкрите) і «Stalled» (зависле).

Зверніть увагу, що статус вирішеного є для завдання спадковим, тому впливатиме на відображення і поведінку завдання у кожному проекті (і на кожній робочій панелі), де воно є. Це не залежить від колонки, у якій завдання може бути, на будь-якій робочій панелі. Тому завдання може бути відкритим і знаходитися в колонці DONE однієї робочої панелі, але в колонці DOING — іншої. Воно також може бути в колонці десь іще.

У результаті, важливо не позначати завдання вирішеним, поки воно не буде таким для УСІХ проектів, яким належить. Прийнятно перемістити завдання у Вашій робочій панелі в колонку DONE, але перш ніж позначити його вирішеним, переконайтеся, що жодному іншому проекту не треба спостерігати за його поступом.

«Слідкуючі» завдання
Цей термін запозичений з Баґзілли, де він мав конкретне значення: завдання, що встановлювалось як таке, що блокується іншими завданнями, але саме собою не представляє жодної роботи, і не прив'язане до певного релізу чи дати. Прикладом могло бути завдання з назвою «Почистити документацію», яке могло мати купу підзавдань, кожне з яких описувало конкретний шмат роботи, який треба зробити. Такі «слідкуючі» завдання часто висіли довгий час (або й постійно), тоді як підзавдання вирішувались, але й створювались нові. У Фабрикаторі краще створити проект (теґ) для категоризації такого типу роботи.

Зверніть, однак, увагу, що є інші типи «безробітних» узагальнюючих завдань, які все ж є сенс мати у Фабрикаторі. Зокрема завдання «Release». Майбутній реліз може бути представлений завданням, яке містить у вигляді підзавдань (так званих блокуючих завдань) усю фактичну роботу, яку треба зробити для цього релізу. Коли реліз виходить, завдання вирішується. Подібне використання — мати завдання, яке представляє загальні цілі команди на квартал, тоді кожна ціль може бути (або не бути) блокуючим підзавданням.

Пошук елементів


Phabricator consists of several applications (task management in "Maniphest" being one of them, and in the future also Diffusion and Differential for code review). The search field in the upper corner allows searching across all these applications.

Використання Maniphest'у (розширений пошук)


Maniphest — це інструмент, який дозволяє користувачам робити деталізовані запити. Користувачі можуть уточнити запит, використавши багато параметрів. Запити також можна зберігати і впорядковувати.

Нові користувачі можуть знайти декілька попередньо збережених запитів у самому Maniphest'і. Натискання на «Advanced Search» відкриє нову сторінку пошуку.

Натисніть тут, щоб отримати детальний огляд Maniphest'у.

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

Натисніть тут, щоб отримати детальний огляд панелі.

Пакетні редагування
Фабрикатор надає можливість робити масові/пакетні редагування завдань. У кінці кожного пошукового запиту Maniphest'у Ви знайдете посилання «Batch Edit Selected» на редагування усіх редагувань, які виберете натисканням з клавішею Shift. Користувачі, які хочуть користуватися цією функцією, мають приєднатися до групи оцінювачів (Triagers). See also this this comment for a hack to bulk edit tasks on a workboard.

Особисті списки елементів
Функціонал «Flag For Later» пропонує позначити об'єкти (як-то завдання або версії), які «Ви хочете запам'ятати проглянути пізніше». Доступні вісім кольорів прапорців. Прапорці особисті і приватні, тож Ваші списки інші не бачитимуть. Ваші позначені об'єкти перераховані на сторінці flag. Їх можна шукати за кольором чи типом об'єкта, на відміну від токенів.

Створення проекту


У Фабрикаторі проекти є теґами, теґи — проектами. Ієрархія через підпроекти доступна з лютого 2016. Завдання можуть бути приписані більш, ніж одному проекту, і також можуть бути подані без приписування жодному проекту.

Коли Вам треба проект?
В загальному, Вам треба проект…
 * коли у Вас є визначена команда, що працює над одним чи кількома проектами (почніть з цього, запитуйте більше, лише якщо Вам треба більше)
 * коли Вам треба робоча панель (тобто спринт)
 * коли Вам треба теґ чи ключове слово, щоб задати тип завдання, яке може бути частиною будь-якого проекту (наприклад, «Доступність»)

Запит на новий проект
Див. Фабрикатор/Запит на новий проект.

Обмеження доступу до завдань
Будь ласка, див. загальний огляд і випадну функцію «Security» у завданнях на сторінці Фабрикатор/Безпека. Див. налаштування проектів за замовчуванням (і використання пробілів) на сторінці Фабрикатор/Створення і перейменування проектів#Правила.

Displaying and using a Space


''Spaces (upstream documentation) allow restricting access to groups of objects (like tasks) to members of a specific group only. See Restricting access via Space policies for setting up.''

If you can access at least two spaces, you see an additional Spaces dropdown under "Visible To" when creating and editing an object. Users with access to only one space will not see this control.



In Maniphest's task view, the Space will also be displayed in front of the task summary. You can batch-edit tasks to move them to a different Space.

Note that you will still have to associate the corresponding "public" project (if existing) to a task to make a task in a restricted Space (which you have access to) to show up in search queries and the workboard of the project. The "public" project could be automatically added via requesting a global Herald rule.

When creating tasks in Spaces, use the "Create Advanced Task" option in the "Create Task" dropdown. This option will display an additional Spaces dropdown under "Visible To" in the task creation UI that will allow you to set visibility to the Space for which this task should be visible.

If you instead create a task via the "Create Simple Task" option in the "Create Task" dropdown, then after you create it, you will have to edit the task to restrict visibility to members of the Space. Before this edit, the task will be visible to anyone and notifications about your task might have been sent to public logged IRC channels and other subscribed individuals.

Шаблони і посилання MediaWiki

 * Ви можете посилатися на завдання Фабрикатора з вікісторінок, використовуючи  та його коротшу версію , наприклад,   дає приклад.
 * Template:Tracked оновлено, щоб включати посилання на об'єкти Фабрикатора — див. справа, як виводиться введене.
 * Template:Phabricator також доступний;  дає.

Наявні посилання і шаблони на Баґзіллу далі працюватимуть, тому що ці посилання продовжують вказувати на bugzilla.wikimedia.org, який перенаправляє їх на конвертовані завдання Фабрикатора.

Використання Conpherence
Conpherence — це аплікація Фабрикатора, яка дозволяє приватні розмови між двома і більше користувачами, подібно до миттєвих повідомлень і приватних кімнат чату. Жодна команда цього не використовує. Воно може конфліктувати з іншими каналами комунікації. Щоб дізнатися більше, натисніть тут.

Conpherence має необов'язкове постійне вікно/колонку, яку можна показати і приховати клавішею «\». Користувачі можуть випадково активувати цю функцію, і назад її можна приховати клавішею «\» (графічного інтерфейсу для її приховання нема).

Статистика
Фабрикатор пропонує таблиці, які показують відкриті завдання за пріоритетом і за користувачем або проектом. Окрім цього, Фабрикатор не підтримує подальшої статистики, метрики, діаграм, звітів (наприклад, за період часу) чи чогось такого, ні вбудованих, ні через API. Phragile and Phlogiston are further reporting tool options for Phabricator.

Diffusion


Diffusion — це браузер репозиторія Фабрикатора та інструмент керування репозиторієм. Кінець кінцем ми хочемо замінити Gerrit для вичитки коду і керування репозиторієм і gitblit для віддзеркалення репозиторія в режимі «тільки читання». Прямо зараз, ми дублюємо деякі свої репозиторії Git на Фабрикатор з метою демонстрації.

Інші посилання

 * Інші
 * phabricator-production, споживач OAuth, використовуйте Special:OAuthManageMyGrants для керування під'єднаними програмками
 * Етикет Фабрикатора