Phabricator/Help/fr

Dear Phabricator user, if you have questions, just ask in the Discussion page. We improve our documentation based on the feedback received.

Pour une compréhension global de phabricator, suivez le lien qui suit. Ou continuer à lire cette page pour entrer directement en matière et faire vos premiers pas.

What is Phabricator and what does it do?|Qu’est-ce que Phabricator et que permet-il de faire ?

Créer votre compte et configurer les avertissements

 * Premièrement, assurez vous que vous êtes wikimédia.
 * Si vous n’en possédez pas encore,.
 * Allez sur la Phabricator login page|page de connexion (lorsque vous êtes déconnecté l’interface web pour les postes de bureau affiche le lien correspondant en haut à droite sous forme d’une flèche pointant vers une porte)
 * Activez le bouton représentant un tournesol qui est libellé « s’authentifier ou s’enregistrer ».
 * Une fenêtre de dialogue vous demandera l’autorisation de vous connecter à mediawiki.org
 * phabricator vous demandera un nom d’utilisateur. En cas de doute, utilisez simplement votre nom d’utilisateur wikimedia, remarquez cependant que les noms d’utilisateur de phabricator ne peuventcomprendre que des caractères latins, donc vous ne pourrez pas utiliser des termes comme العَرَبِيةُ ou 中华民族. Vous devrez également fournir une adresse mél, mais elle ne sera pas communiquer aux autres utilisateurs.
 * Suivez le lien Profile (en haut à droite)>Edit Profile et complétez le champ « Also Known As » (également connu comme) pour faciliter les recherches vous concernant.


 * Paramétrage avancé
 * Si vous avez un compte wikitech.wikimedia.org, aussi nommé compte LDAP ou Gerrit, vous pouvez également l’utiliser pour vous authentifier. Le même compte phabricator peut être relié à la fois au compte MediaWiki.org et au compte LDAP. Cela peut servir de moyen de replie dans le cas improbable ou le compte unifié wikimédia ne fonctionnerait pas. Connect your Wikimedia SUL and LDAP accounts|Connectez votre compte unifié wikimedia et votre compte LDAP au même et unique compte phabricator !. Sans quoi vous créerez deux comptes phabricator séparés.
 * Nous n’encourageons pas l’utilisation d’une authentification multifactoriel sur le phabricator wikimedia. Si vous souhaitez néanmoins l’utiliser, lisez les multi-factor authentication guidelines and requirements|prérequis et recommandations pour l’authentification multifactorielle.

Revendiquer vos anciens comptes Bugzilla et RT
Follow the link here.|Suivez ce lien.

Être tenu au courant des mises-à-jour et recevoir des alertes
Phabricator vous alerte des activités significatives, y compris concernant vos propres actions. Vous pouvez ajuster vos email preferences|préférences méls comme il vous sied, pour recevoir des alertes web seulement pour certaines activités, voir ne recevoir aucune notification.

Phabricator propose plusieurs outils pour réceptionner les alertes que vous souhaitez recevoir.


 * Si vous êtes intéressé par un objet bien déterminé (une tâche, une maquette…), suivez simplement le lien vers la page . L’ajout d’un commentaire vous abonnera automatiquement.
 * Si vous êtes intéressé par toutes les activités d’un projet, vous pouvez suivre le lien  sur la page de présentation du projet ou vous rendre sur la page    du projet et vous y ajouter comme membre. Après cela, rendez-vous sur la page principal du projet (via le premier bouton du la barre de navigation de projet sur la gauche) et suivez le lien  . Vous pouvez également vous contente de vous abonner à des projets, ce qui se fait automatiquement lorsque vous en devenez membre. Ces deux cas ce distingues par le fait que des avertissements ne sont envoyés que si des changements dans le projet est destiné aux abonnés aux tâches, plutôt qu’au projet.

Vous pouvez également définir dans vos préférences méls pour quelles événements précis vous souhaitez, ou non, être alerté pour une tâche donnée (ex. : le changement de statut, de propriétaire, de priorité ou de la liste des abonnés). Les utilisateurs les plus prolifiques pourraient souhaiter paramétrer les méls à un minimun, comme sur la File:Phabricator email settings panel.png.

Paramétrer des services d’alerte Herald

Suivez ce lien pour apprendre comment paramétrer des systèmes d’alerte ''' sur mesure (personnalisées) dans l’instance Herald du phabricator de Wikimedia. Ce sont des options avancées dont la prise en main peut-être plus difficile.

Créer une tâche
Il existe trois façons de créer une tâche, en fonction des informations que vous souhaitez rapporter :
 * toute nouvelle tâche : activez le bouton  ou suivez le lien Create Task qui se situe en haut à droite. Vous serez dirigé sur un formulaire à compléter.
 * Une sous-tâche d’une tâche existante : suivez le lien « Create Substask » situé dans lu colonne de droit de la tâche courante. La relation de dépendance entre les deux tâches sera paramétré et quelque valeurs de la tâche parente sera récupéré comme valeur par défaut (Assigne To, CC, Priority, Projects). Les sous-tâches seront répertoriés dans la tâche parente, triés par date d’ajout en débutant par les plus récentes.
 * Une tâche similaire à une tâche existante : après avoir crée une tâche, un lien Similar Task (« tâche similaire ») est proposé dans le coins supérieur droit. Suivez ce lien pour précompléter les champs Assigne To, CC, Priority et Projects avec les mêmes valeurs. Complétez le formulaire, sans toucher aux champs pour les lesquels vous n’êtes pas sûr d’un choix de valeur idoine.

Mise en forme
Phabricator offre quelques fonctionnalités de formatage pour les champs de texte. Voir l’aide sur la mise en forme de phabricator.

Sélection de projets
Pour relier une tâche à un projet qui utilise phabricator, il suffit de commencer à saisir son nom dans le champ « Projects » et de sélectionner le projet dans la liste des résultats correspondants (la liste ne montrera que cinq projets correspondant). Vous pouvez ajouter un ou plusieurs projets à ce champ. En cas de doute, il est possible de ne pas le renseigner, les personnes s’occupant du triage des tâches se chargeront d’attribuer une valeur idoine. Il existe une (très longue) liste des projets disponibles. Le bouton   permet de recherche des projets. Cette liste est également disponible sur la page Phabricator/Projects.

Paramétrer la priorité d’une tâche
La priorité devrait être paramétré par des chefs de produit, des chargés de projet, des développeur qui prévoient de travailler sur la tâche, des inspecteurs de ticket (bugwrangler) ou des membres expérimentés de la communauté, pas par les personnes qui soumettent le ticket ou par des observateurs externes. Voir la Phabricator project management|gestion de projet de phabricator pour plus d’informations.

Utilisation du mél
Il est également possible de créer des tâches en envoyant des mél à [mailto:task@phabricator.wikimedia.org task@phabricator.wikimedia.org]. Le sujet sera utilisé comme titre, le corps sera utilisé directement tel quel, et les pièce jointe seront associés à la tâche. Les mots clés (hashtag) peuvent être utilisé dans le corps du message pour associer la tâche à un projet.

''Note : si la signature du compte mél expéditeur n’utilise par le standard de fait – qui comprends l’utilisation d’un ligne avec deux tiret (« -- ») pour la séparer du corps de texte – elle sera intégré à la tâche. La suppression des informations privées de la signature est vivement encouragée lors des premiers essais, juste au cas où.''

Passage de certaines valeurs dans l’URL de la création de tâche
"Report a bug in Phabricator" link can pass numerous values via URL parameters appended to the generic task creation link.

This is a very advanced feature. Learn more here.

Writing comments and descriptions
Phabricator allows you to post and edit comments and descriptions using text formatting and inserting images or other files; see Uploading file attachments. You can use toolbar at the top of the input text area and you can use Phabricator's 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 CC 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.
 * Adding a project name as in  will create a link to the project main page.
 * If you want to quote text, you can simply add " " at the beginning. 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.
 * If you want to display an uploaded mockup image file, e.g., like, embedded in your comment, write.
 * If you want to create an external link, e.g.  in wiki markup, use   including the whitespaces in Phabricator.
 * If you want to add a web address (URL link) in a comment for example to provide a testcase, it is highly recommended to copy and paste the full web address from your web browser's address bar, e.g.,  instead of  . Interwiki prefixes like   are not supported in Phabricator and most customizations that Bugzilla had neither, e.g., Gerrit changes should be pasted as full web addresses too.
 * If you want to paste lines of code, add a line with three backticks before and after the code: . Or create a Paste and link to the Paste from the task.

Note that Phabricator's own markup language is different from MediaWiki's markup. The upstream Phabricator instance hosts a Remarkup Reference for Phabricator's own markup language.

Uploading file attachments
There are several ways to upload files: You can add a file (for example a screen photo) to a comment or a task description via drag and drop with your mouse. Users can also copy and paste images via the clipboard functionality of their system.

If this is not available on your system you can use phab:dashboard/ 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.

Advanced users could also use "arc upload" which provides an F number that can be used via  syntax to embed in a comment.

Note that you cannot upload a file and then decrease the access level to the file (e.g linking it to a restricted security ticket). You would have to delete the file and reupload it with stricter access permissions. It is recommended to upload files which should have restricted access together with the creation of a restricted (security) ticket.

If you ever need to delete a file that you uploaded, open the file/ overview, select "Authored", select the file and click "Delete File" in the sidebar.

Project management in Phabricator
If you maintain or manage a project, please follow this link for more details.

Tasks and workflow
Each Phabricator Workboard has a column flagged as "Default", and any new task added to that Project will start off in that column.

Blocking tasks
Tasks can block, or be blocked by, any number of other tasks. This feature can be used to accomplish a few different things:


 * Blockers. A task might simply be blocked by another task, representing a dependency (see Phabricator/Project management on how to add a blocking task).
 * Subtasks. A parent task would be blocked by its subtasks. (There is no other way to mark parent/subtask relationships).
 * Tracking. A "workless" task blocked by several tasks might be tracking a collection of tasks within a release or other time period (see #"Tracking" Tasks below).
 * Approval. Several tasks (such as draft team goals) might be blocked by a single task which represents the draft tasks getting approved, after which those draft goals are now real goals.

NOTE: There is a "Create Subtask" feature. In addition to setting up the correct blocking/blocked-by relationship, it also caries the CC (subscription) list into the new subtask. Once the subtask has been created, it is simply a blocking task. The explicit "subtask" state is not preserved.

Prioritization
Each Task has a Priority field, which is reflected in the sidebar color of Tasks that appear in Workboards. Note that this Priority is inherent to the Task, and thus will be the same in every Project and Workboard that task appears in.

Within a Workboard, Tasks can be arranged in a priority order within a column. Choose "Natural" sort, and then drag-and-drop Tasks up or down within a column. This allows a groomed backlog to be sequenced by priority, or could indicate the urgency of items in a "Needs Review" column. Note that Workboard columns can also be sorted by the underlying Priority field, so while discussing a Workboard with someone not in the room, it is best to agree on and use the same sort order to avoid confusion.

Assignment
Each Task may be assigned to one person. As with Priority, this is inherent to the Task, and affects every Project that Task is in. So it is impossible to have a Task assigned to Robin in one Project, but to Kim in another. The assigned person is displayed as part of the Task card in each Workboard.

Some teams might choose to assign Tasks to people while the Tasks are in a TODO column. Others would have people assign Tasks to themselves only at the moment that they are moving them from TODO to DOING. Assigning a Task to yourself before you are ready to work on it is a form of "cookie licking".

After the main work on a Task is finished, there are 2 main patterns for assignment:


 * The Task remains assigned to whoever did the work, as that task's permanent owner
 * The Task gets reassigned to whoever needs to work on it next

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 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