Phabricator/Help/uk

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

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

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

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

 * Спершу переконайтеся, що Ви Вікімедіа.
 * Якщо у Вас ще нема вікімедійної обліковки,.
 * Go to the Phabricator login page (the link shows as an arrow to a door in the top right when you're logged out).
 * Click the sunflower button that says "Login or Register - MediaWiki".
 * You will be asked by MediaWiki.org to approve connecting.
 * Фабрикатор попросить Вас ввести ім'я користувача. Якщо сумніваєтеся, просто використайте вікімедійне ім'я користувача, але зауважте, що ім'я користувача в Фабрикаторі не може містити символи не латинкою, як-то العَرَبِيةُ чи 中华民族. Також вимагається вказати адресу електронної пошти, але вона не буде видима іншим користувачам.
 * Натисніть на Profile (угорі справа) > Edit Profile і вкажіть про себе Also Known As (наприклад, своє повне ім'я), щоб Вас було легше шукати.


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

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

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

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


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

Ви також можете визначити у своїх налаштуваннях електронної пошти, для яких окремих дій (напр., змін статусу, власника, пріоритету чи підписників) у завданні Ви б хотіли (не) отримувати сповіщень. Продуктивні користувачі, вірогідно, захочуть зменшити налаштування пошти до мінімуму, як на 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/ Див. цю довідку про форматування у Фабрикаторі.]

Обирання проектів
In order to relate a task with a project that uses Phabricator, you just need to start typing its name in the Projects 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 Projects field. You can add one or more projects to the Projects 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 про його власну розмітку.

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

If this is not available on your system you can use phabricator:file/upload and refer to the file number (like "123") that is shown after a successful upload by writing  in a comment. This will create a link to the file. To include the file in the comment, enclose the ID in braces:. 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» на бічній панелі.

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

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

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


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

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

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

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

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

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

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


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

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

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

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

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

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

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

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


Фабрикатор складається з кількох аплікацій (менеджмент завдань у Maniphest'і — одна з них, у майбутньому також будуть вичитка коду та інші). Поле пошуку у верхньому кутку дозволяє шукати у всіх цих аплікаціях.

Натисніть тут, щоб отримати опис простих функцій пошуку.

Однак він дуже обмежений. Він має власну версію розширеного пошуку. І це не порівнюється з повним набором функцій і гнучкістю Maniphest'у.

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


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

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

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

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

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

Пакетні редагування
Фабрикатор надає можливість робити масові/пакетні редагування завдань. У кінці кожного пошукового запиту Maniphest'у Ви знайдете посилання «Batch Edit Selected» на редагування усіх редагувань, які виберете натисканням з клавішею Shift. Користувачі, які хочуть користуватися цією функцією, мають приєднатися до групи оцінювачів (Triagers).

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

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


У Фабрикаторі проекти є теґами, теґи — проектами. Немає деревовидної ієрархії, і немає підпроектів, поки що. Завдання можуть бути приписані більш, ніж одному проекту, і також можуть бути подані без приписування жодному проекту.

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

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

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

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

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

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

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

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

Статистика
Фабрикатор пропонує таблиці, які показують відкриті завдання за пріоритетом і за користувачем або проектом. Окрім цього, Фабрикатор не підтримує подальшої статистики, метрики, діаграм, звітів (наприклад, за період часу) чи чогось такого, ні вбудованих, ні через API.

Diffusion


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

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

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