From Fedora Project Wiki

(→‎Developer FAQ: I want to be notified just once when ticket/patch is created, not for every change.)
(phabricator is discontinued)
 
(10 intermediate revisions by 2 users not shown)
Line 1: Line 1:
We use a tool called [http://phabricator.org/ Phabricator] to manage our tickets and review commits. Our instance is available at:
QA instance of Phabricator has been discontinued.
 
'''https://phab.qadevel.cloud.fedoraproject.org'''
 
You can [https://phab.qadevel.cloud.fedoraproject.org/maniphest/task/create/ create a ticket] for us there (report a bug, suggest a feature) against [https://phab.qadevel.cloud.fedoraproject.org/project/query/all/ one of our tracked projects].
 
== User FAQ ==
 
<dl>
<dt> Do I need to create yet another account?
<dd> No. If you need to log in (to e.g. create a ticket), use your '''FAS email address''' (that is <code>nick@fedoraproject.org</code>). You'll be redirected to FAS where you supply your password and then back to Phabricator. No new account is necessary.
 
<dt> The main page is confusing.
<dd> Use the navigation toolbar on the left:
* ''Differential'' will let you see all patch reviews or create a new one manually (for a better way, see [[User:Tflink/taskotron_contribution_guide]]).
* ''Maniphest'' will let you see current tickets (bugs, requests) or create a new one (look into the upper right screen corner).
* ''Projects'' will show you a list of our projects. You will need this when creating a new ticket to provide a correct project name.
* ''[https://phab.qadevel.cloud.fedoraproject.org/feed/ Feed]'' (available from ''Applications'') will show you the latest changes in Phabricator.
 
<dt> I receive too much email for the tickets I'm subscribed to. Every single ticket change is announced.
<dd> Go to your [https://phab.qadevel.cloud.fedoraproject.org/settings/panel/emailpreferences/ Email preferences] and set which types of action you want to get email notifications for.
</dl>
 
== Developer FAQ ==
 
<dl>
<dt> I want to be notified for all tickets in a certain project, even if I'm not directly subscribed to them.
<dd> Visit the desired project from the [https://phab.qadevel.cloud.fedoraproject.org/project/ list of projects]. Make sure you're looking at the project details page (the top icon in the left bar) - for certain projects, the workboard is displayed by default. Now click on ''Join Project'' and then on ''Watch Project''. From now on, you'll receive notifications about every ticket change related to this project. You can cancel your subscription from here as well.
 
<dt> I want to watch for ticket changes with more complicated rules, not just per-project.
<dd> Use [https://phab.qadevel.cloud.fedoraproject.org/herald/ Herald tool]. You'll be mostly interested in ''Maniphest Tasks'' (tickets) rules or ''Differential Revisions'' (patch reviews) rules. These rules are evaluated for every ticket/review change. For example you can specify that if a ticket has a certain keyword in its description, you'll get automatically subscribed to it. Example:
<pre>Name: kparal: track interesting keywords
Applies To: Maniphest Tasks
 
When any of these conditions are met:
  Title matches regexp /(upgradepath|depcheck|autoqa|rpmguard)/i
  Body matches regexp /(upgradepath|depcheck|autoqa|rpmguard)/i
Take these actions the first time this rule matches:
  Add emails to CC kparal</pre>
Please always put <code>your_nick:</code> to the beginning of your rule name, as shown above.
 
<dt> I want to be notified for all patch reviews for a certain project/repository, even if I'm not listed among reviewers.
<dd> Use Herald tool (see above). You'll either need to list the repositories you're interested in, or you can list the projects these repositories are related to (each repository can be related to one or more projects), see [https://phab.qadevel.cloud.fedoraproject.org/diffusion/query/all/ the list of all repositories] and the relevant projects displayed next to each of them, looking like "tags". Example:
<pre>Name: kparal: watch revisions for selected repositories
Applies to: Differential Revisions
 
When all of these conditions are met:
  Repository is any of rWTCMS (python-wikitcms), rFAKE (fake_fedorainfra)
Take these actions the first time this rule matches:
  Send an email to kparal</pre>
<pre>Name: kparal: watch revisions for selected projects
Applies to: Differential Revisions
 
When all of these conditions are met:
  Repository's projects include any of repos-taskotron, infrastructure, papercuts, testCloud
Take these actions the first time this rule matches:
  Send an email to kparal</pre>
 
<dt> I want to be notified of tickets without any project set (usually bug reports from people not familiar with Phabricator).
<dd> Use Herald tool (see above). Example:
<pre>Name: kparal: notify me of tasks without project set
Applies To: Maniphest Tasks
 
When any of these conditions are met:
  Projects does not exist
Take these actions the first time this rule matches:
  Send an email to kparal</pre>
 
<dt>I want to be notified just once when a ticket/patch is created, not for every change.
<dd> If you start watching a certain project, you'll receive all changes of all tickets. <br>
You'll also receive all changes of tickets/patches, if you use a Herald rule containing:
<pre>Add emails to CC &lt;name&gt;</pre>
If you want to receive the notification just once, use this action in a Herald rule:
<pre>Send an email to &lt;name&gt;</pre>
You can then decide whether to subscribe to that ticket/patch and receive further notifications, or ignore it and not receive any further notifications for that item.
 
[[Category:QA]]

Latest revision as of 12:44, 7 August 2017

QA instance of Phabricator has been discontinued.