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 globale de Phabricator, suivez le lien qui suit. Ou continuez à lire cette page pour entrer directement en matière et faire vos premiers pas.

Qu’est-ce que Phabricator et que permet-il de faire ?

Créer votre compte



 * Premièrement, assurez vous que vous êtes wikimédia.
 * Si vous n’en possédez pas encore,.
 * Allez sur la page de connexion de Phabricator (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 peuvent comprendre que des caractères latins, donc vous ne pourrez pas utiliser des termes comme العَرَبِيةُ ou 中华民族. Vous devrez également fournir une adresse mail, mais elle ne sera pas communiquée 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.
 * Cliquez sur Manage dans la barre de navigation à gauche.
 * Cliquez sur Edit Profile et remplissez le champs « Also Known As » (par exemple, avec votre nom complet) pour qu’il soit plus facile de vous chercher.


 * 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 récupération dans le cas improbable ou le compte unifié Wikimédia ne fonctionnerait pas. 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 prérequis et recommandations pour l’authentification multifactorielle.

Revendiquer vos anciens comptes Bugzilla et RT
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 préférences mail 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.

Vous pouvez également définir dans vos préférences mail pour quels é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 mails à un minimum, comme sur le File:Phabricator email settings panel.png. En tant que membre d’un projet, vous pouvez désactiver les mails du projet via le bouton  sur la page Members du projet. Il y a plus d’informations dans le Guide de l’utilisateur sur la gestion des emails.
 * 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.

Paramétrer des services d’alerte Herald
Suivez ce lien pour apprendre comment paramétrer des systèmes d’alerte  sur mesure (personnalisés) 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ée et quelques valeurs de la tâche parente seront récupérées comme valeurs par défaut (Assigne To, Subscribers, Priority, Projects). Les sous-tâches seront répertoriées dans la tâche parente, triées par date d’ajout en commençant 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, Subscribers, 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 (le taguer) 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 correspondants). Vous pouvez également chercher un projet en cliquant sur la grande icône dans le champ Tags. Vous pouvez ajouter un ou plusieurs projets au champ Tags. 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 disponible. Le bouton  permet de rechercher 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éveloppeurs 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 gestion de projet de Phabricator pour plus d’informations.

Utilisation du mail
Il est également possible de créer des tâches en envoyant des mails à [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èces jointes seront associés à la tâche. Pour ajouter un projet, utilisez la commande correspondante !projects et le mot-clé (hashtag) au début du corps. Par exemple,. Les consignes ci-dessus pour paramétrer l’assignement de la tâche, sa priorité ou son statut par mail sont disponibles.

''Note : si la signature du compte mail expéditeur n’utilise pas le standard – 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 essai, 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 lien générique de création de tâche.

C’est une fonctionnalité très avancée. 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 descriptions en utilisant de la mise en forme et l’insertion d’images ou d’autres fichiers ; voir « 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 » de 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 souscrire à 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, passez 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 (lien 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 pastecré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 officielle de développement continu 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 phabricator:file/upload et faire référence au numéro de fichier (par exemple « 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 :. Par défaut c’est inclus comme une miniature. Pour plus d’options de formatage, visitez « Remarkup reference ». Si vous devez téléverser des fichiers fréquemment et considérez les options actuelles inconfortables, vous pouvez aussi ajouter un panneau à votre page principale avec un lien direct.

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.

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 permettre le suivi d’une collection de tâches liés à un objectif de version à publier comme stable, ou une période temporelle (voir #Tâches suivies ci-dessous).
 * Approbation. Plusieurs tâches (comme des ébauches ou des objectifs d’équipe) peuvent être bloquées 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 tri 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 équipes 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écessiter une revue de code d’autres personnes spécifiques. Dans le second cas, la tâche serait assignée à cette personne, ce qui indiquerait de façon claire 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 teste 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ée à 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éée, de façon à 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 par défaut 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).

Remarquez que cet état Resolved est inhérent à la tâche, et qu’il affectera l’apparence et le comportement de la tâche dans tous les projets et tableaux de bord où elle apparaît. C’est une propriété indépendante de la colonne où apparaît la tâche. Aussi une tâche peut être ouverte et apparaître dans la colonne des éléments accomplis (DONE), d’un tableau de bord, mais dans la colonne des travaux en cours (DOING) dans un autre. Elle pourrait aussi apparaître dans ailleurs dans la colonne.

Aussi, mieux vaut veiller à ne pas déclarer une tâche comme résolue jusqu’à ce qu’elle le soit pour tous les projets où elle apparaît. Ce n’est pas un problème de déplacer une tâche dans la colonne des tâches accomplis de votre propre tableau de bord, mais avant de la déclarer achevée, assurez-vous qu’aucun autre projet ne souhaite continuer à en suivre la progression.

Tâches suivies
Ce terme est emprunté à Bugzilla, où un sens bien particulier lui était attribué : une tâche qui est définie comme bloqué par d’autres tâches, mais qui en elle même ne correspond à aucune activité à exécuter, pas plus qu’elle n’est liée à un jalon de publication ou à une date butoir. Ces tâches de suivie avaient tendance à demeurer longtemps (voir éternellement) sans évolution, étant donné que leurs sous-tâches courantes pouvaient être résolues pendant que de nouvelles leurs étaient attribuées. Dans Phabricator, mieux vaudrait créer un projet (étiquetage, tag) pour catégoriser un type d’activité.

Remarquez cependant qu’il existe d’autres types de tâche qui ne sont associables à aucune activité particulière à entreprendre, mais qui ont toutes leur place dans Phabricator. C’est notamment le cas des tâches de jalon de publication (Release). Un publication à venir pourrait être représentée par une tâche répertoriant comme sous-tâche (également appelées tâches bloquantes) toutes les activités qu’il est nécessaire de réaliser pour atteindre l’objectif de la publication. Une fois la publication effectuée, la tâche peut être marquée comme achevée. Une utilisation similaire serait d’avoir une tâche qui représente les objectifs globaux d’une équipe pour le trimestre, et avec comme tâches bloquantes chacun des objectifs.

Rechercher des éléments


Phabricator est composé de plusieurs applications répondant à plusieurs besoins complémentaires :
 * la gestion de tâche de "Maniphest" ;
 * la Diffusion, qui sera mise en place ultérieurement ;
 * la Comparaison pour revoir le code, qui sera également mise en place ultérieurement ;
 * et encore bien d’autres applications.

Le champ de recherche dans le coin supérieur de l’écran permet de retrouver des éléments à travers l’ensemble de ses applications.

Utiliser Maniphest (Recherche avancée)


Maniphest est un outil qui permet à l’utilisateur de formuler des demandes très pointues et de faire des recherches approfondies. Les utilisateurs peuvent raffiner leurs requêtes en utilisant de multiples paramètres. Elles peuvent également être sauvegardées et il existe tout un ensemble de fonctionnalités de gestion de ces requêtes sauvegardées.

Maniphest propose aux nouveaux utilisateurs un ensemble préétabli de requête. Suivez le lien « Advanced Search » (recherche avancée) pour vous rendre sur la page éponyme.

Suivez ce lien pour consulter une visite guidée détaillée de Maniphest.

Utiliser le tableau de bord
Les tableaux de bord sont des pages d’accueil pour afficher un grand nombre d’informations conçus sur mesure. Elles peuvent créées, administrées et partagées avec d’autres utilisateurs.

Consultez cette page pour une visite guidée détaillée du tableau de bord.

Modfication par lot
Phabricator offre des fonctionnalité de traitement par lot pour modifier plusieurs tâches. En bas de page des formulaires de requête permettant de faire des recherches Maniphest se trouve un lien « Batch Edit Selected » (Modification par lot de la sélection) qui permet d’agir sur les tâches que vous avez sélectionné. Les utilisateurs désireux de faire appel à cette fonctionnalité doivent d’abord rejoindre le groupe des défricheurs de rapports d’anomalie.

Listes personnalisées d’éléments
La fonctionnalité "Flag For Later" (Consigner pour plus tard) permet de marquer les objets (comme des tâches ou des révisions) pour lesquels vous souhaiter disposer d’un aide mémoire vous rappelant de le consulter ultérieurement. Huit couleurs de drapeau sont disponibles. Les drapeaux sont uniquement accessible depuis le compte auquel ils sont reliés. Vos drapeaux sont répertoriés sur la page flag. Il est possible d’effectuer des recherches par couleur ou type d’objet, contrairement aux |symboles.

Créer un projet


Dans phabricator les objets sont des étiquettes et inversement. Il n’existe pas de gestion de la hiérarchie des étiquettes, et des sous-projets, « pour le moment ». Les tâches peuvent être assignées à plus d’un projet, et elles peuvent être soumises sans être assignées à aucun projet.

Quand créer d’un projet ?
Généralement, vous aurez besoin d’un projet si :
 * vous avez une équipe existante qui s’occupe d’un ou plusieurs projets (commencez par cela, et demandez au fur et à mesure de vos besoins) ;
 * vous avez besoin d’un tableau de bord ;
 * vous avez besoin d’une étiquette ou d’un mot clé pour organiser un type de tâche qui peut faire partie d’un projet quelconque (par exemple : « Accessibilité »).

Demander la création d’un projet
Voir Demande de création d’un nouveau projet.

Restreindre l’accès à des tâches
Veuillez, s’il-vous-plaît, consulter la page dédiée à la gestion de la sécurité à l’aide de Phabricator pour accéder à une vue d’ensemble en générale et à l’option « Security » du menu déroulant des formulaire de soumission de tâche en particulier. Voir la politique relative à la création et au renommage de projet pour les paramétrages par défaut des projets et les notes relatives à l’utilisation de caractères espaces.

Les modèles MediaWiki et les liens

 * Vous pouvez créer des liens vers les tâches Phabricator dans les pages wiki en utilisant  et son abréviation , par exemple   génère le lien exemple.
 * Le modèle Template:Tracked a été mis à jour pour prendre en compte les liens vers les objets de Phabricator. Regardez sur la droite pour voir comment  est rendu.
 * Le modèle Template:Phabricator est également disponible  génère.

Les liens et modèles Bugzilla existants continueront de fonctionner, en pointant sur bugzilla.wikimedia.org qui s’occupera de rediriger vers la tâche correspondante sur l’instance Phabricator.

Utilisation de Conpherence
Conpherence est une application Phabricator qui permet de réaliser des conversations privées entre plusieurs utilisateurs, comme avec une messagerie instantanée ou des salles de discussion privée. Aucune équipe n’a actuellement signalé en faire usage, ce qui – le cas échéant – pourrait mener à des utilisations de canaux de communication concurrents à ceux existant. Apprenez en plus sur cette page.

Conpherence propose, en option, une fenêtre/collone persistante qui peut être affiché et caché avec la touche barre oblique inverse (\) du clavier. Remarquez que les utilisateurs pourraient involontairement activer cette fonctionnalité, et que seul un second appui sur la même touche permet de faire disparaître ce composant d’interface : il n’existe pas de composant dans l’interface graphique qui permet d’effectuer cette permutation d’affichage.

Statistiques
Phabricator permet de consulter des tableaux qui montre les tâches ouvertes par priorité conjointement à un tri soit par utilisateur, soit par projet. Phabricator ne propose cependant pas d’autre fonctionnalité de statistique, de mesure, de diagramme, de rapport (ex : en fonction du temps) ou quoi que soit de ce genre, que ce soit de façon intégrée ou par appel à l’interface abstraite de programmation. Phragile and Phlogiston are further reporting tool options for Phabricator.

Diffusion


Diffusion est l’outil de gestion de dépôt et de navigation dans les dépôts. À terme il remplacera Gerrit pour la revue de code et la gestion des dépôts, et gitblit pour les dépôts miroirs en lecture seule. Actuellement, l’équipe technique s’occupe de mettre en place quelques miroirs des dépôts Git de Wikimédia dans phabricator à des fins de démonstration.

Autres liens

 * Autres
 * OAuth consumer phabricator-production, utilise Special:OAuthManageMyGrants pour la gestion des applications connectées
 * Phabricator etiquette