MediaWiki

Фабрикатор/Довідка

< Phabricator
This page is a translated version of the page Phabricator/Help and the translation is 19% complete.
Outdated translations are marked like this.
Languages:
Фабрикатор призначений для повідомлення про баги в програмному забезпеченні, запитів на функції та планування роботи.
  • Щоб поставити технічні запитання про проєкти Вікімедіа, див. сторінку m:Tech
  • Щоб поставити технічні запитання щодо MediaWiki поза використанням ФВМ, див. Project:Support desk

Шановний користувач Фабрикатора! Якщо у Вас є запитання, просто поставте їх на сторінці обговорення. Ми покращимо нашу документацію на основі отриманих відгуків. If you want to test Phabricator, use the Cloud Services instance. (The test instance is unfortunately not always online.)

Для основного огляду того, що є і що може зробити фабрикатор, перегляньте навчальні відео на Wikimedia Commons:

  • Basics and Environment
  • Tasks
  • Projects and Workboards
  • Searching and Listing Tasks
  • Individual Productivity

There are also slides if you have a low bandwidth. Or keep reading this page to dive right in and get started.

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

You can connect your new Phabricator account to either your global Wikimedia wiki account or your Wikimedia developer account. In both cases, no separate password is needed.

Using your global wiki account

  • Сайт MediaWiki.org попросить вас схвалити підключення вашого облікового запису до фабрикатору.
  • Фабрикатор попросить Вас ввести ім'я користувача. When in doubt, you can use your Wikimedia username, but note that Phabricator usernames cannot include non-ASCII characters such as العَرَبِيةُ or 中华民族 or Xï, nor spaces. Instead of a space, use an underscore "_". You will also need to provide a valid email address for verification, but your address will not be visible to other users.[1]
  • Клацніть на Управління на навігаційній панелі ліворуч або у розкривному меню під вашим порожнім зображенням профілю (у верхній панелі, ліворуч від поля пошуку).
  • Натисніть на Ред. профіль і заповніть поле «Also Known As» (наприклад, з вашим повним ім'ям), щоб інші могли легше вас знайти.

Using your Wikimedia developer account

Якщо у вас є обліковий запис розробника Вікімедіа — також відомий як обліковий запис LDAP або Gerrit або обліковий запис wikitech — ви також можете використовувати його для входу. Одне і те ж ім’я користувача Phabricator може підключати як MediaWiki.org, так і LDAP. Це може бути резервна копія, у малоймовірному випадку Wikimedia SUL не працює. If you are WMF staff or contractor, please do also connect your Wikimedia SUL account (your global wiki account) created by WMF ITS.
Приєднайте свої облікові записи SUL та LDAP до одного імені користувача Фабрикатора! Інакше Ви створите у Фабрикаторі два різні облікові записи.


Multi-factor authentication

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

Troubleshooting

Accessing Phabricator

  • Due to persistent abuse, some IPs from specific countries (such as Egypt) are blocked from accessing Phabricator. Some proxies, some VPNs and some Tor exit nodes are also blocked. When accessing Phabricator using these IPs, users will see an HTTP error (500 or 501). If your IP is blocked, and you cannot find a usable proxy to access Phabricator, you can contact security wikimedia.org to request whitelisting your IP.

Email addresses

  • If you can't verify your Phabricator account because you entered an incorrect email address, please add a note on Talk:Phabricator/Help.

(If that's not possible, contact the Bugwrangler.) We can't correct your email address for you, but we can delete your account to allow you to register again.

  • If you see the error "Email address already taken" when trying to create a Phabricator account on the page "Login or Register - MediaWiki", you have likely already registered a Phabricator account with such email address. You may recover that account using this link.

Changing accounts

  • To change your Phabricator username, please add a note on Talk:Phabricator/Help and include a link to your Phabricator profile.
  • You can change the global wiki account or developer account connected to your Phabricator account via "refresh account" link.

Other issues

To claim your old Bugzilla and/or RT account(s), click this link.

Отримання оновлень і сповіщень

Фабрикатор повідомляє вас про відповідну діяльність, включаючи ваші власні дії.

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

  • Якщо Вам цікавий окремий об'єкт (завдання, макет тощо), просто клацніть Subscribe на його сторінці. Додавання коментаря підпише Вас автоматично.
  • Якщо Вас цікавить уся діяльність в межах проекту, ви можете натиснути на Watch Project на сторінці огляду проєкту. There is more information in the Projects user guide under "Watching Projects". Note that being a member of a project does not mean that you get notified about project activity.

See Phabricator/Help/Managing mail for reducing the amount of mail notifications and about filtering mail notifications.

Troubleshooting

If you receive unexpected mail notifications for a task:

  • You might be subscribed to the task.
  • In your email preferences under "Maniphest Tasks", you might have enabled "One of a task's subtasks changes status".
  • If nothing helps, check the "X-Phabricator-Stamps" message header field for further information.

See Phabricator/Help/Managing mail .

Створення більш складних правил для сповіщень (Геральд)

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

Створення завдання

 
One of the Task creation forms. This is the "Simple Form".

There are several ways to create a task, depending on the information you want to carry:

  • A new task: click the Bookmark button toward the right side of the top navigation bar. From the dropdown menu, choose Create Task. You will get a blank form.
  • A security problem: click the Bookmark button toward the right side of the top navigation bar.

From the dropdown menu, choose Report Security Issue. You will get a form pre-tagged with Security, and with a link to special instructions for filing security bugs.

  • Підзавдання дійсного завдання: натисніть на посилання Edit Related Tasks… > Create Subtask у правій колонці поточного завдання. Буде встановлено залежність між двома завданнями і деякі значення батьківського завдання буде заповнено автоматично (Assigned To, Subscribers, Priority, Projects). Зв'язок між двома завданнями буде показано в «Task Graph». Please review and adjust the project tags and the subscribers before creating a subtask!

Заповніть форму, залишивши поля, у яких Ви не впевнені, незміненими.

Phabricator supports some formatting in text areas. See #Formatting and markup.

Use the live preview at the end of the page to check whether your text looks as you expect.

Обирання проєктів

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

Вказання пріоритету завдання

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

Використання e-mail

Ви також можете створювати завдання, надсилаючи електронні листи на task@phabricator.wikimedia.org. Тема листа має бути назвою завдання, тіло буде використане, як воно є, а прикріплення будуть додані до завдання. Щоб встановити проект, додайте відповідну команду «!projects» та його хештеґ на початку тіла, наприклад, $hashtag. The subject will be used as the 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., !projects #mediawiki-general. Further commands to set the task assignee, priority or status via email are available.

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

Вказання певних значень в URL створення завдання

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

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

Another option is to request a custom form for task creation which also supports setting a task subtype (e.g. "bug report" or "feature request"). See custom forms.

Task status and life cycle

See Bug report life cycle for the meaning of the Status field values.

To close a task as a duplicate of another task, select "Edit Related Tasks… > Close As Duplicate" in the side bar.

Assigning yourself a task

To assign yourself a task:

  1. Go to the task
  2. Click "Edit Task" in the Actions sidebar on the right.
  3. Add your username to the "Assigned To" field
  4. Click "Save Changes" at the bottom

Commenting and editing a task

To reply, you need an account as well. Фабрикатор дозволяє дописувати і редагувати коментарі й описи, використовуючи форматування тексту та вставку зображень чи інших файлів; див. Завантаження файлів-прикріплень. Ви можете використовувати панель інструментів у верхній частині області введення тексту, і ви можете використовувати власне форматування фабрикатору.

Use the live preview at the end of the page to check whether your text looks as you expect.

To edit the description of a task, select "Edit Task" in the side bar.

Changing a task's subtype

The subtype can be edited via the comment area's "actions" section:

 
Example of changing Phabricator ticket subtype

Formatting and markup

Phabricator supports some formatting in text areas.

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

Популярне використання розмітки включає:

  • Mentioning users as in @username will create a link to their profile and will subscribe them to the task.
  • Adding a task number as in T123 will create a link to the task including a hover card.

{T123} inserts the title of the task in your text.

  • Додавання назви проєкту у вигляді #Project створить посилання на головну сторінку проєкту.
  • Якщо Ви хочете цитувати текст, можна просто додати ">" на початку. Якщо хочете відповісти на коментар, включивши його як цитату, натисніть на випадну стрілку у правому кінці коментаря, на який відповідаєте.

If you want to reply a comment including it as a quote, click the drop down arrow at the right end of the comment you want to reply.

  • Якщо Ви хочете відобразити завантажений файл-макет, наприклад, зображення M123, вбудованим у Ваш коментар, впишіть {M123}.
  • Якщо хочете створити зовнішнє посилання, наприклад, [https://www.mediawiki.org example] у вікірозмітці, скористайтеся [example](https://www.mediawiki.org) включно з пробілами у Фабрикаторі.
  • Якщо Ви хочете додати веб-адресу (URL-посилання) у коментарі, щоб, наприклад, вказати на тестовий випадок, рекомендовано скопіювати і вставити посилання з адресного рядка Вашого браузера, наприклад, $example. Do not use mw:Project:Support desk. Interwiki prefixes like mw: are not supported in Phabricator.
  • If you want to paste lines of code, add a line with three backticks before and after the code: ```.

You can also indent two spaces. Or create a Paste and link to the Paste from the task.

  • Use [ ] item to define list items with checkboxes in the task description.

Change it to [X] item to resolve a list item.

Завантаження файлів-прикріплень

  Увага: You should upload patches for review to Gerrit , unless it is a security patch.
  Увага: Phabricator file uploads inherit permissions from the tasks to which they are posted, which often makes them publicly-viewable. See below for more details.

Є декілька способів завантажувати файли: Ви можете додати файл (наприклад, знімок екрану) у коментар або опис завдання, перетягнувши його туди мишкою. Користувачі також можуть копіювати і вставляти зображення через буфер обміну своєї системи. You can also click the "cloud" icon while editing / creating / commenting on a task and use the dialog.

Якщо у Вашій системі це неможливо, можете скористатися https://phabricator.wikimedia.org/file/upload/ і послатися на номер файлу (наприклад, «123»), який відобразиться після успішного завантаження файлу, вписавши F123 у коментар. Це створить посилання на файл. Щоб включити файл у коментар, візьміть ID файлу у фігурні дужки: {F123}. This will create a link to the file. To include the file in the comment, enclose the ID in braces: {F123}. Per default it's included as thumbnail. Більше опцій форматування у Форматування та розмітка. 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.

The size of the uploaded files is limited to ~4 MB.[2]

File visibility

Files uploaded through https://phabricator.wikimedia.org/file/upload/ always become public, visible to everyone. (Keep this in mind in case e.g. the file is related to a restricted security ticket.)

Files uploaded while editing/creating/commenting on a task are private, and visible to no one except the file's uploader, until they are attached to the task (at which point those who can see the task can also see the file).

Відстежується на Фабрикаторі
Завдання T310833

Attaching the file to the task usually happens automatically when you save your changes, but it is possible to bypass this by accident – for example, by uploading the files on one task, then cutting-and-pasting the resulting {F...} markup into another task. When this happens, you (the uploader) will still be able to see the file, but no one else will see it. To resolve this problem, find the "Referenced Files" section in the task's sidebar, then click "File Not Attached" on the files marked in red and follow the scary prompts to attach it.

  • <span lang=
  •  
    Others can't view the file
  •  
    You can view the file
  •  
    Attaching dialog
  •  
    Grant permission dialog
  •  
    Confirmation on the task
  •  
    Others can view the file now!

File management

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

You can also change the visibility of a file by viewing its page (such as https://phabricator.wikimedia.org/F35287447), then clicking "Edit File" in the sidebar and changing the "Visible To" field.

File access security

Note that anyone with the full URL to a file (such as https://phab.wmfusercontent.org/file/data/svlzontonhy6xxdjxwga/PHID-FILE-zbgqfq7jqirt2s24y5e3/red.png, not https://phabricator.wikimedia.org/F35287447) can download the file or share the link with others. There is no authentication protecting these file URLs from being accessed. Phabricator files rely entirely on security through obscurity; guessing the (pseudo-random) URL for any given file would be very difficult, if not impossible. If you need more protection for particularly sensitive files then you should consider a more secure alternative.

Управління проєктами

Read Phabricator/Project management for essential information on maintaining and managing projects, e.g. on using project workboards, common practices, and agile workflows.

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

Запит на новий проєкт

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

Коли Вам треба проєкт?

В загальному, Вам треба проєкт…

  • 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")

Батьківські завдання та підзавдання

Завдання можуть бути батьківським завданням або підзавданням будь-якої кількості інших завдань. Якщо завдання A неможливо розв’язати, доки не буде розв’язано завдання B, то завдання A є батьківським завданням, а завдання B — підзавданням. Такі відносини можна встановити за допомогою «Редагувати пов’язані завдання…». Батьківські завдання та підзавдання відображаються під «Графіком завдань» у завданні. Цю функцію можна використовувати для виконання кількох різних завдань:

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

A "workless" (parent) task blocked by several (sub)tasks might be tracking a collection of (sub)tasks within a release or other time period. Note that "Tracking" here has a different meaning from the deprecated #Tracking tag in Phabricator.

  • Схвалення. Декілька (батьківських) завдань (наприклад, чернетки командних цілей) можуть бути блоковані єдиним (під)завданням, яке показує, що чернеткові завдання схвалено, після чого чернетки цілей стають реальними цілями.

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

Визначення пріоритетності

See Phabricator/Project management#Setting task priorities

Призначення

See Phabricator/Project management#Assigning tasks

«Слідкуючі» завдання

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

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

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

Search context (global vs advanced)

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

This one is fairly simple. It is in the upper right corner. By default, it searches across all applications and hence all types of documents (open tasks, closed tasks, code commits, etc…). You can change the default context using the arrow menu to the left of the search bar. For example, select "Open Tasks" to only show results in open tasks from the Maniphest issue tracker. Or select "Current Application" to search Maniphest in Maniphest, Diffusion in Diffusion etc. Tags specified are unioned (OR'd).

  • Advanced, application specific search, for example at https://phabricator.wikimedia.org/maniphest/query/advanced/ for Maniphest. This one has more fields, and auto-completion that includes "Not in:..." (equivalent to NOT) and "In any:..." (equivalent to OR) (for example, type "echo" in the "Tags" field). There is also an advanced search for most other applications (e.g. phab:file/query/advanced for Files). To only search for tasks / bug reports, use the Maniphest advanced search. Tags specified are intersected (AND'd).

Inside Maniphest, custom, saved searches and advanced search options are listed in the navigation bar on the left.

Search terms

Special care needs to be put in choosing correct search terms.

Some locally-valid properties for the "Query" field:

  • Case insensitive: Edit is the same as eDIt
  • phrase search works: "fatal error"
  • basic tokenization is performed, e.g. to strip punctuation
  • Stemming is performed: "edited" is also found when searching for edit. However, "edited" does not match edit as quoted text does not stem.
  • Substring search is supported: ~amp matches example, but amp does not.
  • ~"an examp" matches an example as quoted and substring-operator text uses substring search.
  • Boolean queries to exclude certain terms are possible by using the - symbol before the unwanted term. E.g. use -non fatal error to exclude "non-fatal" errors from results.
  • To only search in a task title but not in the task description or comments, use title:quick ferret which is the same as title:quick title:ferret. To search for one term in the task title and other terms anywhere in a task, use ferret title:quick or title:quick all:ferret. See https://secure.phabricator.com/book/phabricator/article/search/ for more information.

The advanced search forms are not explicit about the logic but in general use AND between different fields.

You can exclude specific projects from the results by entering not(projectname) (equivalent to NOT) and combine several projects via any(projectname) (equivalent to OR) via the auto-completion suggestions.

There's a limit of 5 items in the maniphest autocomplete.

To increase this limit, see these userscripts for Chrome and for Firefox.

You can search for specific task IDs by leveraging a hidden "IDs" field, revealed when a search URL takes the following format:

https://phabricator.wikimedia.org/maniphest/?ids=1,2,3,4#R

After the field is revealed, while you can still get results by manipulating the URL directly, you can also input directly into the field. The format is the number of the task only (removing the typical T prefix), comma-separated. This can be useful if you are pasting tasks from another place, such as a spreadsheet or database.

Another way to reveal the "IDs" field on various search forms is by enabling the "Expert Mode" checkbox in your Phabricator user settings. To enable expert mode, first visit https://phabricator.wikimedia.org/settings/ and then click the "Developer Settings" menu on the left sidebar.

Alternatives ways to find something

If you don't remember the exact words used in an item you are looking for you can follow one of these paths:

  • use the activity feed and edit the query to be restricted to certain projects or timeframes
  • use the activity feed to list all actions that you performed in a certain timeframe at phab:feed/query/EW2FwdAi.Kfz/
  • use an external search engine;
  • remove all search terms, refine the search only by project etc. and then scan all the possible results manually or use Ctrl+F to search specific strings (this might require setting "Page Size" to a high value to display more than only 100 results);
  • file a new task, mentioning that a past report exists as well, and wait for someone to merge the new report to the old.

Selecting Dates and Date Ranges

This is only available in the Advanced Search.

Using the Date fields like "Created After" and "Created Before" allow entering absolute and relative dates. Note that Maniphest uses UTC.

To get a list of tasks which were created in the last 24 hours, set the "Created After" field to "-24 hours" or "-1 day". Note that "Updated Before" actually means "Last updated before" and that absolute date values like "2014-11-26" refer to UTC time while your time zone setting might be different.

The "Updated After" and "Updated Before" fields return any and all changes to a task.

For example, when a task is moved to another column in a board it registers as "updated". This may add noise to your search results.

Examples of how Maniphest interprets searches:

  • "02/25/2015" - interpreted as "00:01 on February 25th, 2015" (UTC)
  • "5 days ago" - interpreted as "00:01 on the fourth calendar day before today" (UTC)
  • "2:45 AM 5 days ago" - interpreted as "02:45 on the fourth calendar day before today" (UTC)

The "X days ago" range can be confusing. Phabricator interprets today as part of any data set. Even if it is 12:30 UTC, Phabricator will interpret that as a potential day in the range.

Saving and Managing Searches/Queries

Queries can be saved and managed inside Maniphest.

Maniphest offers links to some predefined search queries in the navigation bar on the left. For example, click authored to get a list of tasks that you have created.

Search query addresses (URL) are stable so you can save and reuse them. You can share the address in your web browser's address bar with other people, e.g. via posting the link on a wikipage.

If you want to save a search, select the "Save Query" button at the bottom of the Advanced Search UI.

When looking at the navigation bar on the left in Maniphest, click on the "Edit Queries…" link. You will see a list of your saved queries. All users have a default set which can be deleted in this UI.

Some options in this UI:

  • Use the line elements on the left to drag queries up and down in the list.
  • The x will permanently delete a Query.
  • The Pencil icon allows a user to edit the name of a query
  • Clicking on the name of a Query will bring up the search options and results of that query

Once you save a query, you cannot change its parameters, but you can change its name. To edit a query, click on it's name, change parameters and save it as a new query. Also, Phabricator allows users to save multiple queries with the same name.

To make the user name dynamic (e.g. for "Tasks assigned to the person running this query") in searches that you'd like to share with others, select Authors > Magnify glass icon > Browse Users > "Current viewer".

Note that some common queries are also available in the "Activity" tabs on the Phabricator frontpage.

Finding the Maniphest task corresponding to a Bugzilla bug number

This is only available in the Advanced Search.

All Phabricator tasks migrated in 2014 from Bugzilla have a Reference field that contains a value bz followed by the number of the equivalent report in Bugzilla. If you want to search the task corresponding to a specific Bugzilla report, use the Reference field in the advanced search or just add 2000.

Reporting spam or abuse

In case of spam or vandalism on Phabricator, the best place to report it is on the #wikimedia-releng connect IRC channel. (Wikimedia Foundation staff not on IRC can post in a relevant Slack channel like #engineering-all.)

In case of harassment or offensive behavior, follow the instructions at Code of Conduct#Report a problem .

Розширені функції

Використання панелей

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

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

Пакетні редагування

Фабрикатор надає можливість робити масові/пакетні редагування завдань. 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 wanting to use this feature need to join the acl*Batch-Editors group. Note: to see more than 100 tasks at a time, you can update Page Size in the query.

Batch editing can be reversed by noting the "Bulk Job" ID that is generated at the start of a Batch Edit. This can be accessed by clicking "Details" before or after executing. On the following page, there will be a "Continue" menu item to the right, which will generate a Maniphest query of all the affected tasks.

If you have to perform the very same 'uninteresting' action on a lot of tasks (cleanup or reorganizing project structures) and you do not want tasks to send typical notifications, ask someone with CLI server access (people listed under phabricator-admin or phabricator-roots) to silence that specific batch edit before running it, so no notifications will be sent for tasks in that batch edit. Silent batch-moves of tasks from one column to another column (via "Move tasks to column…" in the column header dropdown) on the same workboard are not supported as of July 2020.

Please be mindful about silencing a batch edit. For example, silencing is usually not appropriate for closing tasks as task subscribers would expect to get a notification.


Favorites

The Bookmark menu toward the right side of the top navigation bar can be customized with links to your preferred forms and actions. See the Profile Menu instructions for more information.

Особисті списки елементів

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

Phabricator badges

Badges are awarded to users to distinguish certain people or people in a particular group.

Currently all active badges can only be awarded by administrators.

Обмеження доступу до завдань

New tasks

Access to a task that you plan to create can be restricted to a list of specific users by changing the "Visible To" field to something else than "Public". This requires using a form which shows the "Visible To" field (for example the default advanced form). Note that setting "All Users" on a task will not restrict access to a task, as everybody can simply create an account and then still access a task with that visibility. To avoid vandalism, this "Visible To" field is only available to users who are members of some ACL projects or WMF-NDA. A list of all projects that you are a member of is available.

If you are a member of the #WMF-NDA project tag, then access to a task that you plan to create can be restricted to members of the #WMF-NDA project by clicking the Bookmark dropdown in the top bar and selecting "NDA Protected Task".

Security issues

If you want to file a new Security issue, you must follow Reporting security bugs to make sure that the initial task is not public! An existing task can be converted into a Security issue via "Protect as security issue" in the side bar.

Existing tasks

Access to an existing task can be changed via "Edit Task" and then changing the "Visible To" field to something else than "Public". Note that setting "All Users" on a task will not restrict access to a task, as everybody can simply create an account and then still access a task with that visibility. To avoid vandalism, this "Visible To" field is only available to users who are members of some ACL projects or WMF-NDA. A list of all projects that you are a member of is available.

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.

  •  
    Task creation view when having access to at least two Spaces
  •  
    Task view when the task is in a non-public Space
  •  
    Workboard view of two tasks in a non-public Space

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

Основна сторінка: Help:Interwiki linking
Відстежується на Фабрикаторі
Завдання T177
Вирішено
  • * Ви можете посилатися на завдання Фабрикатора з вікісторінок (через міжвікі-посилання), використовуючи phabricator: та його коротшу версію phab:, наприклад, [[phab:T454|приклад]] дає приклад.
  • Template:Tracked оновлено, щоб включати посилання на об'єкти Фабрикатора — див. справа, як виводиться введене {{Tracked|T177|resolved}}.

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

Статистика

On every project page you find a "Reports" link in the sidebar. This is mostly useful for team projects. It offers information on task throughput, age of tasks, workload per assignee, distribution of open tasks per workboard column, a burndown chart, and an activity chart. You can also filter the data for a certain time period.

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.[4]

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

Some additional overall statistics can be found in the "Phabricator monthly statistics" emails sent to wikitech-l.

Exporting task data

The results of an Advanced Search query on phab:maniphest/query/advanced/ can be exported to CSV and JSON formats. Use the "Use Results ▶ Export Data" in the upper right corner. If you are on the workboard of a project, the column header dropdown menu allows you to "View Tasks as Query" per column.


Перегляд коду (Diffusion)

Further information: Phabricator/Diffusion

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

To request and set up a new code repository, see Gerrit/New repositories/Requests.

Default fields (Forms)

Further information: Phabricator/Help/Forms

Phabricator allows some customization of the fields shown for a given task, prefilled values for fields, and setting a task subtype (e.g. "bug report" or "feature request"). These are handled via the Forms feature.

API (Conduit)

Conduit is the name of the web API. https://phabricator.wikimedia.org/conduit/ offers some explanation and examples. See the Conduit upstream documentation. See also Phabricator/Bots .

Phatality

Phatality is a plugin for the Wikimedia production Logstash installation which makes it easier to create Phabricator tasks for production errors.

See Introducing Phatality.

Automated Regular Search Summaries

  • You can get a regular email with the results of a saved Phabricator query.
  • The emails are currently delivered by the PhabSearchEmail tool maintained by RhinosF1 on a weekly or monthly basis although, more frequenices can easily be added.
  • To request a summary email, fill out this form and let RhinosF1 know your email.

Get Notified about new UBN Tasks

See Setup UBN Notifications

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

  1. ↑ However, if you have made commits to any repositories mirrored in Phabricator (regardless of whether the commit was in Gerrit or elsewhere), other users will be able to see the connection between the account and the email address.
  2. ↑ phab:T243113#5814392
  3. ↑ T3670 (підпроєкти, вимагає входу в систему), у поточній версії Фабрикатора
  4. ↑ T13279 T1562 (статистика), у поточній версії Фабрикатора
  5. ↑ Посібник користувача браузера репозиторія Diffusion, у поточній версії Фабрикатора
Retrieved from "https://www.mediawiki.org/w/index.php?title=Phabricator/Help/uk&oldid=6806592"