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

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 être ouverte et apparaître dans la colonne des des éléments accomplis (DONE) d’un tableau de bord, mais dans la colonne des traveaux 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 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é, 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éfini comme bloqué par d’autres tâches, mais qui en elle même ne corresponds à aucune activité à exécuter, pas plus qu’elle n’est liée a un jalon de publication ou à une date butoir. Ces tâches de suivie avait 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 associable à aucune activité particulière à entreprender, mais qui ont toute leur place dans phabricator. C’est notamment le cas des tâches de jalon de publication (Release). Un publication à venir pourrait être représenté 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é 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 revue de code, qui sera 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 ces applications.

Suivez ce lien pour une description simple de ces fonctionnalités.

Cependant la page ne fournie qu’un ensemble très limité d’informations. Elle contient une présentation de quelques recherches avancées. Cependant elle est loin de couvrir l’ensemble des fonctionnalités et rendre compte de de toute la flexibilité de Maniphest.

Utiliser Maniphiest (Recherche avancée)
Maniphest est un outil qui permet à l’utilisateur de faire dee formuler des demandes très pointus et de faire des recherches approfondies. Les utilisateurs peuvent raffiner leurs requêtes en utilisant de multiples paramètres. Elle peuvent également être sauvegardé 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és 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 coleurs de drapeau sont disponible. Les drapeaux sont uniquement accessible au compte auquel ils sont reliés. Vos drapeaux sont répertoriés sur la page Special:MyLanguage/Phabricator/Tokens. 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é à plus d’un projet, et elles peuvent être soumises sans être assigné à 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.

Let modèle MediaWiki et les liens

 * Vous pouvez créer des liens vers les tâches phabricator dans les pages wiki en utilisant  et son abbréviation , par exemple   génère le lien exemple.
 * Le modèle Template:Tracked à été mis à jour pour prendre en compte les liens vers les objets de phabricator. Voyez sur la droit 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 – 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 trie 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é ou par appel à l’interface abstraite de programmation.

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