Phabricator/Help/uk

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

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

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

Creating your account



 * Спершу переконайтеся, що Ви Вікімедіа.
 * Якщо у Вас ще нема вікімедійної обліковки,.
 * 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.
 * Phabricator will ask you for a username. In case of doubt, just use your Wikimedia username, but note that Phabricator username cannot include non-Latin characters such as العَرَبِيةُ or 中华民族. An email address will also be required, but not shown to other users.
 * Click on Manage in the navigation bar on the left.
 * Click Edit Profile and set your Also Known As (for example, to your full name) to make it easier to search for you.


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

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

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

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

Ви також можете визначити у своїх налаштуваннях електронної пошти, для яких окремих дій (напр., змін статусу, власника, пріоритету чи підписників) у завданні Ви б хотіли (не) отримувати сповіщень. Продуктивні користувачі, вірогідно, захочуть зменшити налаштування пошти до мінімуму, як на File:Phabricator email settings panel.png As a project member, you can opt out of project mail via the  on the project's Members page. There is more information in the Managing Phabricator Email user guide.
 * Якщо Вам цікавий окремий об'єкт (завдання, макет тощо), просто клікніть  на його сторінці. Додавання коментаря підпише Вас автоматично.
 * If you are interested in all the activity within a project, you can click  on the project summary page.

Створення правил 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, 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 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 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
You can also create tasks by sending email to [mailto:task@phabricator.wikimedia.org task@phabricator.wikimedia.org]. The subject will be used as task title, the body will be used directly as is, and attachments will be included on the task. To set a project, add the corresponding command "!projects" and its hashtag at the beginning of the body, e.g.,. Further commands to set the task assignee, priority or status via email are available.

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

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

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

Написання коментарів та описів
Фабрикатор дозволяє дописувати і редагувати коментарі й описи, використовуючи форматування тексту та вставку зображень чи інших файлів; див. Завантаження файлів-прикріплень. Ви можете скористатися панеллю інструментів угорі поля вводу тексту і можете використати у Фабрикаторі Remarkup. At the end of the page you have a live preview to check whether your text looks as you expect. Popular use of markup includes:
 * Mentioning users as in  will create a link to their profile and will subscribe them to the task.
 * Adding a task number as in  will create a link to the task including a hover card.   inserts the title of the task in your text.
 * Додавання назви проекту у вигляді  створить посилання на головну сторінку проекту.
 * Якщо Ви хочете цитувати текст, можна просто додати " " на початку. Якщо хочете відповісти на коментар, включивши його як цитату, натисніть на випадну стрілку у правому кінці коментаря, на який відповідаєте.
 * Якщо Ви хочете відобразити завантажений файл-макет, наприклад, зображення, вбудованим у Ваш коментар, впишіть.
 * Якщо хочете створити зовнішнє посилання, наприклад,  у вікірозмітці, скористайтеся   включно з пробілами у Фабрикаторі.
 * Якщо Ви хочете додати веб-адресу (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:. Per default it's included as thumbnail. For more formatting options, visit Remarkup reference. 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» на бічній панелі.

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

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


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

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

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

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

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

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

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


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

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

«Зроблено»
Each Task has a Status field, which includes the state of Resolved. Resolved tasks are by default hidden from Workboards. When they are displayed, they appear grayed out and struck out. Other statuses include Open and Stalled.

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

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

«Слідкуючі» завдання
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.

Зверніть, однак, увагу, що є інші типи «безробітних» узагальнюючих завдань, які все ж є сенс мати у Фабрикаторі. Зокрема завдання «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).

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

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


In Phabricator projects are tags, tags are projects. Hierarchy via sub-projects is available since February 2016. Tasks can be assigned to more than one project, and they can also be submitted without assigning them to any project.

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

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

Обмеження доступу до завдань
Будь ласка, див. загальний огляд і випадну функцію «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.

Шаблони і посилання 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 для керування під'єднаними програмками
 * Етикет Фабрикатора