Phabricator/Help/fr

Cher utilisateur de phabricator, si vous avez des questions, n’hésitez pas à simplement poser votre question sur la page de discussion. Nous améliorons notre documentation en nous basant sur les retours qui nous sont faits.

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
Un lien « Signaler un problème via phabricator » peut fournir de nombreuses valeurs par les paramètres adjoints au generic task creation link|lien générique de création de tâche.

C’est une fonctionnalité très avancée. Learn more here|Plus d’informations sont fournies sur cette page.

Écriture de commentaires et de descriptions
Phabricator permet de poster et d’éditer des commentaires et des description en utilisant de la mise en forme et l’insertion d’images ou d’autres fichiers ; voir Uploading file attachments|téléverser des pièces jointes. La barre d’outil au dessus du champ de texte peut être utilisée à cette fin, de même que la syntaxe « Remarkup » du phabricator. En fin de page se trouve une prévisualisation du rendu en direct qui permet de vérifier si le texte ressemble à ce qui est attendu. Les usages les plus populaires comprennent :
 * le fait de mentionner les utilisateurs préfixés d’un arobase pour créer un lien vers leur page de profil et les mettre en copie de la tâche.
 * l’ajout d’un numéro de tâche, en préfixant d’un T majuscule une chaîne de chiffres qui crée un lien vers la tâche en adjoignant une infobulle de description.   insère le titre de la tâche dans le texte.
 * L’ajout d’un nom de projet en préfixant un terme d’un croisillon  créera un lien vers la page principale du projet correspondant.
 * Si vous souhaitez citer un texte, il suffit de débuter la ligne par le signe supérieur . Si vous souhaitez répondre à un commentaire en l’incorporant sous forme de citation, passé par le menu déroulant symbolisé par une flèche en bas à droite du commentaire à citer.
 * Si vous souhaitez afficher la maquette image d’un fichier téléversé, comme , en l’incorporant dans votre commentaire, écrivez.
 * Si vous souhaitez créer un lien externe, par exemple vers , de façon similaire à la syntaxe wiki, utilisez   mais sans omettre les espaces.
 * Si vous souhaitez ajouter une adresse web (lin URL) dans un commentaire, par exemple pour fournir un prototype de test, il est vivement recommandé de copier et coller l’adresse complète depuis la barre d’adresse du navigateur web. Par exemple  plutôt que  . Les préfixes interwiki comme   ne sont pas pris en compte par l’analyse syntaxique de phabricator, pas plus que la plupart des adaptations qui existaient dans le bugzilla de médiawiki. Les modifications Gerrit devraient également également être recopiées avec des adresses web complètes.
 * Si vous souhaitez recopier un ligne de code, ajoutez des lignes avec trois accents graves avant et après le code. Ou create a Paste|créez une copie en ligne et ajoutez un lien vers la copie.

Remarquez que la syntaxe de mise en forme de phabricator est différente de celle de médiawiki. L’instance amont de phabricator en propose une présentation sous forme d’une référence.

Téléverser des pièces jointes
Il y a plusieurs moyens de téléverser des fichiers : vous pouvez ajouter un fichier (par exemple une capture d’écran) à un commentaire ou à une description de tâche par un simple geste de glisser-déposer réalisé avec une périphérique de pointage. Les utilisateurs peuvent également copier et coller des images à l’aide de la fonctionnalité de presse-papier de leur système.

Si cette fonctionnalité n’existe pas sur le système vous pouvez utiliser un phab:dashboard/ et faire référence au numéro de fichier (par example « 123 ») qui est affiché à coté des fichiers déjà téléversés en le préfixant de la lettre F majuscule. Cela créera un lien vers le fichier. Pour incorporer le fichier dans le commentaire, placez l’identifiant entre accolades :. Si vous devez fréquemment téléverser des fichiers et que vous trouvez les options actuellement proposés incommodes, vous pourriez également ajouter un text panel to your homepage with a direct link|lien direct vers votre page d’accueil.

Les utilisateurs confirmés peuvent également utiliser un « téléversement arc » qui attribue un numéro à chaque fichier et permet d’y faire référence avec la syntaxe.

Remarquez que vous ne pouvez pas téléverser de fichier et postérieurement en restreindre le niveau d’accès (par exemple pour le relier à un ticket à accès restreint sur un sujet de sécurité). Il est cependant possible de supprimer le fichier et le retéléverser avec des droits d’accès restreints. Il est recommandé de téléverser les fichiers dont l’accès doit être restreint directement en pièce jointe lors de la création du ticket (de sécurité) correspondant.

Si jamais vous aviez besoin de supprimer un fichier que vous avez téléversé, ouvrez le file/ de prévisualisation, sélectionnez « Authored » puis le fichier et validez le bouton « Delete File » dans le panneau latéral.

Gestion de projet dans phabricator
Si vous gérez ou êtes responsable d’un projet, veuillez s’il-vous-plaît suivre ce lien pour obtenir plus d’informations.

Tâches et ergorrhée
Chaque tableau de bord de phabricator possède une colonne signalé comme valeur par défaut (Default), et chaque tâche ajoutée à ce projet commencera dans cette colonne.

Blocage de tâches
Les tâches peuvent bloquer ou être bloqué par un nombre quelconque d’autres tâches. Cette fonctionnalité peut être utilisé pour réaliser différents choses :


 * Bloqueurs. Une tâche peut simplement être bloqué par une autre du fait qu’elle dépend de sa réalisation préalable (voir Phabricator/Project management sur comment ajouter une tâche bloquante).
 * Sous-tâches. Une tâche parente sera bloqué par ses sous-tâches. Il n’existe pas d’autre moyen de représenter la relation parent/sous-tâche.
 * Suivi. Une tâche ne correspondant à aucune réalisation spécifique peut être bloqué par plusieurs autres tâches afin de représenté le suive d’une collection de tâches liés à un objectif de version à publier comme stable, ou une période temporelle (voir #Suivi des tâche ci-dessous).
 * Approbation. Plusieurs tâches (comme des ébauches ou des objectifs d’équipe) peuvent être bloqué par une seule tâche qui représente les tâches d’ébauches approuvées, après quoi ces ébauches d’objectif deviennent de réels objectifs.

Remarque : il existe une fonctionnalité « Create Subtask ». En plus de paramétrer les relations idoines de bloquant/bloqué, elle s’occupe également de gérer la liste des abonnements (CC) dans la nouvelle sous-tâche. Une fois que la sous-tâche a été créée, elle devient une simple tâche bloquante. L’attribut « sous-tâche » n’est pas explicitement préservé.

Établissement de priorités
Chaque tâche a un champ priorité, ce qui se reflète dans la couleur du panneau latéral de la tâche qui apparaît sur les tableaux de bord. Remarquez que cette priorité est inhérente à la tâche, et de ce fait sera la même dans tous les projets et tableau de bord où la tâche apparaît.

Sur un tableau de bord les tâches peuvent être rangé par ordre de priorité dans une colonne. Sélectionnez le trie « Natural », puis faites un glisser-déposer des tâches pour les faire monter ou descendre dans la colonne. Ceci permet de séquencer par priorité les accumulations de tâches ayant déjà pris du retard. Remarquez que le colonnes du tableau de bord peuvent également être trié le champ sous-jacent de priorité, aussi lorsqu’il y a discussion non-présentielle d’un tableau de bord, il vaut mieux se mettre d’accord à l’avance et utiliser la même option de trie pour éviter toute méprise.

Assignation
Chaque tâche peut être assigné a une personne. Comme pour les priorités, c’est un attribut inhérent à la tâche, et cela se retranscrit dans tous les projets où elle apparaît. Aussi il est impossible d’avoir une tâche assignée à Ada dans un projet, et à Babage dans un autre. La personne à qui la tâche est assignée est affiché dans le carte de présentation de la tâche sur chaque tableau de bord.

Certaines équpes peuvent choisir d’assigner des tâches à des personnes au moment où les tâches sont dans la colonne TODO (à faire). D’autres choisiront d’assigner de s’assigner eux-même une tâche au moment où il la déplace de la colonne TODO à la colonne DOING (travail en cours). Vous assigner une tâche avant de commencer à la réaliser via le formulaire idoine.

Une fois le travail principal lié à la tâche est accompli, il existe deux motifs principaux d’assignation :


 * 1) la tâche reste assignée à la personne qui a réalisé le travail en tant que responsable permanent de la tâche ;
 * 2) la tâche est réassignée à la prochainne personne qui a besoin d’œuvrer à sa réalisation.

Par exemple, après qu’un code est été rédigé, il pourrait nécessité une revue de code d’autres personnes spécifiques. Dans le second cas, la tâche serait assignée à cette personne, se qui indiquerait de façon clair qui est responsable de la faire avancer. Évidemment si il y a plusieurs personnes susceptibles de faire la revue de code, ce modèle ne fonctionnera pas. Ultérieurement, si la publication nécessite que quelqu’un test le code, le déploie, ou exécute certaines tâches spécifiques pour la compléter (comme une réindexation), la tâche pourrait être assigné à cette autre personne. Une équipe peut avoir une politique qui décide que les tâches accomplies devraient être réassignés à la personne que l’a originellement créé, de façons à ce qu’elle vérifie que ses besoins ont été comblés et que la tâche est prête à être marquée comme close.

tâche accomplie
Chaque tâche a une champ Status, qui comprend son degré d’avancement (Resolved). Les tâches achevées sont généralement omises du tableau de bord, et lorsqu’elles y apparaissent, elles apparaissent grisées et barrées. Les autres états possibles sont ouverte (Open) et bloquée (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