Phabricator/Help/uk

Шановний користувачу Фабрикатора! Якщо у Вас є запитання, просто поставте їх на сторінці обговорення. Ми покращимо нашу документацію на основі отриманих відгуків.

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

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

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

 * Спершу переконайтеся, що Ви Вікімедіа.
 * Якщо у Вас ще нема вікімедійної обліковки,.
 * Перейдіть на сторінку входу в Фабрикатор (коли Ви не в системі, посилання відображається як стілка на двері у верхньому правому кутку).
 * Натисніть на кнопку із соняшником, де пише «Login or Register».
 * MediaWiki.org попросить у Вас підтвердження з'єднання.
 * Фабрикатор попросить Вас ввести ім'я користувача (не може містити символи не латинкою, як-то العَرَبِيةُ чи 中华民族). Якщо сумніваєтеся, просто використайте вікімедійне ім'я користувача. Також вимагається вказати адресу електронної пошти, але вона не буде видима іншим користувачам.
 * Натисніть на Profile (угорі справа) > Edit Profile і вкажіть про себе Also Known As (наприклад, своє повне ім'я), щоб Вас було легше шукати.


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

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

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

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


 * Якщо Вам цікавий окремий об'єкт (завдання, макет тощо), просто клікніть  на його сторінці. Додавання коментаря підпише Вас автоматично.
 * Якщо Вас цікавить уся діяльність в межах проекту, Ви можете натиснути на  на сторінці огляду проекту або перейти на сторінку   у проекті (кнопка «Members» на навігаційній панелі проекту зліва) і додати себе як учасника. Після цього, перейдіть на домашню сторінку проекту (перша кнопка на навігаційній панелі проекту зліва) і натисніть  . Ви також можете підписатися на проекти, що стається автоматично, коли Ви додаєте себе як учасника проекту. Різниця полягає в тому, що підписники отримують сповіщення про зміни, лише якщо проект знаходиться у полі завдання , не в полі.

Ви також можете визначити у своїх налаштуваннях електронної пошти, для яких окремих дій (напр., змін статусу, власника, пріоритету чи підписників) у завданні Ви б хотіли (не) отримувати сповіщень. in a task you would like to (not) receive notifications. Активні користувачі, вірогідно, захочуть зменшити налаштування пошти до мінімуму, як на File:Phabricator email settings panel.png

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

Створення завдання
Є три способи створити завдання, залежно від інформації, яку треба внести:
 * Просто нове завдання: натиснути на кнопку  або посилання Create Task угорі справа. Ви побачите пусту форму.
 * Підзавдання дійсного завдання: натисніть на посилання Create Subtask у правій колонці поточного завдання. Буде встановлено залежність між двома завданнями і деякі значення батьківського завдання буде заповнено автоматично (Assigned To, CC, Priority, Projects). Підзавдання будуть перераховані у батьківському завданні, відсортовані від найсвіжіших.
 * Подібне завдання до того, яке Ви щойно створити: після створення завдання побачите посилання Similar Task у правому верхньому кутку. Натисніть його, щоб заповнити форму тими ж значеннями полів Assigned To, CC, Priority та Projects. Заповніть форму, залишивши поля, у яких Ви не впевнені, незміненими.

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

Обирання проектів
Щоб прив'язати завдання до проекту, який використовує Фабрикатор, Вам просто треба почати вводити його назву у полі Projects й обрати проект зі списку тих, що пасують (у списку буде показано лише п'ять підхожих проектів). Ви можете додати у поле Projects один або декілька проектів. Якщо Ви не впевнені, можете також залишити його пустим — оцінювачі потурбуються про завдання, для яких не вказаний проект. Існує (довгий) список доступних проектів. Натисніть, щоб шукати проекти. (Цей список доступний також на сторінці Фабрикатор/Проекти.)

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

Використання e-mail
Ви також можете створювати завдання, надсилаючи електронні листи на [mailto:task@phabricator.wikimedia.org task@phabricator.wikimedia.org]. Тема листа має бути назвою завдання, тіло буде використане, як воно є, а прикріплення будуть додані до завдання. Щоб обрати проект, використайте його хештеґ десь у тілі, наприклад,.

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

Вказання певних значень в URL створення завдання
Посилання «Report a bug in Phabricator» може містити численні значення у вигляді параметрів URL, прописаних після загального посилання на створення завдання.

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

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

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

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

Якщо у Вашій системі це неможливо, можете скористатися phab:dashboard/ і послатися на номер файлу (наприклад, «123»), який відобразиться після успішного завантаження файлу, вписавши  у коментар. Це створить посилання на файл. Щоб включити файл у коментар, візьміть ID файлу у фігурні дужки:. Якщо Вам треба часто завантажувати файли і доступні варіанти Вам не зручні, Ви також можете додати текстову панель на свою домашню сторінку з прямим посиланням.

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

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

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

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

Завдання і робочий процес
Кожна робоча панель Фабрикатора має колонку, позначену як «Default», і будь-яке нове завдання, що додається у цей проект, опиниться спочатку у цій колонці.

Блокування завдань
Завдання можуть блокувати або бути заблокованими будь-якою кількістю інших завдань. Ця функція може використовуватися для досягнення кількох різних речей:


 * Блокатори. Завдання може бути просто заблоковане іншим завданням, що відображає залежність (див. Phabricator/Project management про те, як додати блокуюче завдання).
 * Підзавдання. Батьківське завдання буде заблоковане своїми підзавданнями. (Немає іншого способу позначити відношення «батьківське завдання/підзавдання»).
 * Відслідковування. «Безробітне» завдання, заблоковане кількома завданнями, може бути відслідковуванням групи завдань в межах релізу чи іншого періоду часу (див. #«Слідкуючі» завдання нижче).
 * Схвалення. Декілька завдань (наприклад, чернетки командних цілей) можуть бути блоковані єдиним завданням, яке показує, що чернеткові завдання схвалено, після чого чернетки цілей стають реальними цілями.

ПРИМІТКА: Існує функція «Create Subtask». На додачу до встановлення коректного відношення «блокуюче/заблоковане», вона також містить список копій (підписок) на нове підзавдання. Коли підзавдання створено, воно є просто блокуючим завданням. Конкретно статус «підзавдання» не зберігається.

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

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

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

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

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


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

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

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

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

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

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

Note, however, that there are other types of work-less umbrella tasks which do still make sense in Phabricator. Notably, "Release" tasks. An upcoming release could be represented by a Task, which lists as subtasks (aka blocking tasks) all the actual work tasks which are targeted for that release. Once the release goes out, it can be resolved. A similar use would be to have a task which represents a teams overall goals for the quarter, and then each goal might (or might not) be a blocking subtask.

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

Click here for a description of simple search features.

However it is very limited. It has its own version of an advanced search. However this does not compare to the full feature set and flexibility of Maniphest.

Using Maniphest (Advanced Search)
Maniphest is a tool which allows users to make detailed queries. Users can refine a query using multiple parameters. Queries can also be saved and managed.

New users will find several saved queries preset inside Maniphest. Clicking on the "Advanced Search" will bring up a new search page.

Click here for a detailed Maniphest walkthrough.

Using Dashboards
Dashboards are specially designed home pages which can display a wide range of custom information. They can be created, managed and shared between users.

Click here for a detailed Dashboard walkthrough.

Batch edits
Phabricator offers the possibility to perform mass/bulk edits for tasks. At the end of any Maniphest search query you will find a "Batch Edit Selected" to edit all the tasks you have selected using Shift-click. Users willing to use this feature need to join the Triagers group.

Personal lists of items
The "Flag For Later" functionality offers marking objects (like tasks or revisions) which "you want to remember to look at later". Eight flag colors are available. Flags are personal and private so your lists cannot be shared with others. Your flagged objects are listed on Special:MyLanguage/Phabricator/Tokens. They can be searched by color or object type, in contrast to tokens.

Creating a project
In Phabricator projects are tags, tags are projects. There is no tree hierarchy, and there are no subprojects, yet. Tasks can be assigned to more than one project, and they can also be submitted without assigning them to any project.

When do you need a project?
In general, you need a project...
 * when you have an established team running one or several projects (start here, ask more only when you need more)
 * when you need a workboard (i.e. a sprint)
 * when you need a tag or keyword to organize a type of task that can be part of any project (for example "Accessibility")

Requesting a new project
See Phabricator/Requesting a new project.

Restricting access to tasks
Please see Phabricator/Security for a general overview and for the "Security" dropdown option in tasks. See Phabricator/Creating and renaming projects for default project settings (and using Spaces).

MediaWiki templates and links

 * You can link to Phabricator tasks from wiki pages using  and its shorter version , for instance   generates example.
 * Template:Tracked has been updated to include links to Phabricator objects — see at the right how  is rendered.
 * Template:Phabricator is also available;  generates.

Existing Bugzilla links and templates will still work, because those links will continue to point to bugzilla.wikimedia.org which will redirect them to the converted Phabricator task.

Using Conpherence
Conpherence is a Phabricator application that enables private conversations between two or more users, similar to instant messaging and private chat rooms. No team is known to use this. It may conflict with other communication channels. To learn more click here.

Conpherence has an optional persistent window/column that can be shown and hidden with the keyboard button "\". Users may accidentally activate this feature, and it can only be hidden again by using the "\" key (there is no graphical UI feature to close it).

Statistics
Phabricator offers tables showing the open tasks by priority and by either user or project. Apart from that, Phabricator doesn't support further statistics, metrics, charts, reports (e.g. over time) or however you may call them, whether built-in or via an API.

Diffusion


Diffusion is the Phabricator repository browser and repository management tool. Eventually we want to replace Gerrit for code review and repository management, and gitblit for repository read-only mirroring. Right now, we're mirroring some of our Git repositories to Phabricator for demonstration purposes.

Other links

 * Other
 * OAuth consumer phabricator-production, use Special:OAuthManageMyGrants to manage connected apps
 * Phabricator etiquette