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. Приписування завдання собі до того, як Ви готові над ним працювати — це бути собакою на сіні.

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


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

So for example, after code has been written, it might needs a code review from some specific person. In the second case, the Task would be assigned to that person, making it clear who is responsible for moving that task forward. Obviously if there are multiple possible code reviewers, that model would not work. Later, if the issue were waiting for someone to test it, or deploy it, or to run some specific task necessary for the Task to be completed (like a re-index), the Task could be assigned to that person. A team might have a policy that completed tasks should get assigned back to the person who originally created them, so that person can verify that their needs were met, and the task is ready to be closed.

"Done"
Each Task has a Status field, which includes the state of Resolved. Resolved tasks are often hidden from Workboards, and when they are displayed, they appear grayed out and struck out. Other statuses include Open and Stalled.

Note that this Resolved status is inherent to the Task, and so will affect that Task's appearance and behavior in every Project (and Workboard) it is in. This is independent of which column a Task might be in, in any given Workboard. So a Task could be Open, and could be in the DONE column of one Workboard, but the DOING column of another. It could also be in the 2016 column somewhere else.

As a result, it is important not to mark a task Resolved until it is considered done by ALL of the projects it is in. It's fine to move a Task to your own Workboard's DONE column, but before you mark a task Resolved, ensure that no other project still wants to keep tracking its progress.

"Tracking" tasks
This term was brought over from Bugzilla, where it had a specific meaning: A task which was blocked on other tasks, but which itself did not represent any work, and which was not tied to a specific release/date. An example might be a Task named "Clean up the documentation", which might then have a variety of subtasks, each of which would describe specific work to be done. These "Tracking" Tasks tended to stick around for a long time (or forever), as their subtasks would get resolved but new ones would get created. In Phabricator, it would be better to create a Project (tag) to categorize this type of work.

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