Merge pull-request #1222

This commit is contained in:
Frederic Guillot 2015-09-12 17:14:45 -04:00
commit 58199b6b29
11 changed files with 460 additions and 0 deletions

70
doc/fr/analytics.markdown Normal file
View File

@ -0,0 +1,70 @@
Analytique
=========
Chaque projet dispose d'une section analytique. En fonction de la façon dont vous utilisez Kanboard, vous pourrez voir les rapports suivants :
Répartition des utilisateurs
----------------
![Répartition des utilisateurs](http://kanboard.net/screenshots/documentation/user-repartition.png)
Ce graphique circulaire affiche le nombre de tâches assignées par utilisateur.
Distribution des tâches
-----------------
![Distribution des tâches](http://kanboard.net/screenshots/documentation/task-distribution.png)
Ce graphique circulaire donne une vue d'ensemble du nombre de tâches ouvertes par colonne.
Diagramme de flux cumulé
-----------------------
![Diagramme de flux cumulé](http://kanboard.net/screenshots/documentation/cfd.png)
- Ce graphique affiche le nombre de tâches de façon cumulée pour chaque colonne en fonction du temps passé.
- Chaque jour, le nombre total de tâches est enregistré pour chaque colonne.
- Si vous souhaitez exclure les tâches terminées, modifiez les [paramètres du projet global](project-configuration.markdown).
Remarque : il faut au moins deux jours de données pour que le graphique apparaisse.
Graphique d'avancement
--------------
![Graphique d'avancement](http://kanboard.net/screenshots/documentation/burndown-chart.png)
Un [graphique d'avancement](http://en.wikipedia.org/wiki/Burn_down_chart) est disponible pour chaque projet.
- Il s'agit de la représentation graphique du travail qui reste à faire en fonction du temps restant.
- Kanboard utilise la complexité des estimations d'achèvement pour créer le graphique.
- Chaque jour, la somme des estimations pour chaque colonne est calculée.
Temps moyen passé pour chaque colonne
-----------------------------------
![Temps moyen passé pour chaque colonne](http://kanboard.net/screenshots/documentation/average-time-spent-into-each-column.png)
Ce graphique affiche le temps moyen passé pour chaque colonne pour les 1000 dernière tâches.
- Kanboard utilise les transitions entre tâches pour calculer les données.
- Le temps passé est calculé jusqu'à la fin de la tâche.
Temps moyen de Lead et Cycle
---------------------------
![Temps moyen passé pour chaque colonne](http://kanboard.net/screenshots/documentation/average-lead-cycle-time.png)
Ce graphique affiche le temps moyen de lead et cycle pour les 1000 dernières tâches au cours du temps.
- Le *lead time* est le temps passé entre la création de la tâche et sa date d'achèvement.
- Le *cycle time* est le temps passé entre la date de début spécifiée et la date d'achèvement de la tâche.
- Si la tâche n'est pas close, la date courante est utilisée à la place de la date d'achèvement.
Ces métriques sont calculées et enregistrées chaque jour pour l'ensemble du projet.
N'oubliez pas de lancer chaque jour le calcul statistique
-------------------------------------------------------
Pour générer des données analytique précises, vous devriez lancer chaque jour le cronjob **statistiques quotidiennes du projet**.
[Consultez la documentation sur la ligne de commande avec Kanboard](cli.markdown)

View File

@ -0,0 +1,137 @@
Actions automatiques
=================
Pour réduire au minimum l'interaction avec les utilisateurs, Kanboard dispose d'actions automatiques.
Chaque action automatique est définie ainsi :
- Un événement à suivre
- Une action associée à cet évènement
- Éventuellement quelques paramètres à définir
Chaque projet a une série d'actions automatisées qui lui sont propres, le panneau de configuration est situé sur la page qui liste les projets, il vous suffit de cliquer sur le lien **Actions automatiques**.
Ajouter une nouvelle action
----------------
### Choisir une action
![Choisir une action](http://kanboard.net/screenshots/documentation/project-automatic-action-step1.png)
### Choisir un évènement
![Choisir un évènement](http://kanboard.net/screenshots/documentation/project-automatic-action-step2.png)
### Définir les paramètres d'une action
![Definir les paramètres](http://kanboard.net/screenshots/documentation/project-automatic-action-step3.png)
Liste des évènements disponibles
------------------------
- Déplacement d'une tâche vers une autre colonne
- Déplacement d'une tâche à un autre emplacement de la même colonne
- Modification d'une tâche
- Création d'une tâche
- Réouverture d'une tâche
- Fermeture d'une tâche
- Création ou modification d'une tâche
- Changement d'assigné à une tâche
- Création ou mise à jour du lien vers une tâche
- Réception d'un *commit* de Github
- Ouverture d'une *issue* de Github
- Fermeture d'une *issue* de Github
- Réouverture d'une *issue* de Github
- Modification de l'assigné à une *issue* de Github
- Modification de l'étiquette d'une *issue* de Github
- Création d'un commentaire d'une *issue* de Github
- Ouverture d'une *issue* de Gitlab
- Fermeture d'une *issue* de Gitlab
- Réception d'un *commit* de Gitlab
- Réception d'un *commit* de Bitbucket
- Ouverture d'une *issue* de Bitbucket
- Fermeture d'une *issue* de Bitbucket
- Réouverture d'une *issue* de Bitbucket
- Modification de l'assigné à une *issue* de Bitbucket issue assignee change
- Création d'un commentaire d'une *issue* de Bitbucket
Liste des actions disponibles
-------------------------
- Fermer une tâche
- Ouvrir une tâche
- Assigner la tâche à un utilisateur particulier
- Assigner la tâche à la personne qui fait l'action
- Cloner la tâche depuis un autre projet
- Déplacer la tâche vers un autre projet
- Déplacer la tâche vers une autre colonne quand elle est assignée à un utilisateur
- Déplacer la tâche vers une autre colonne quand quand l'assigné est supprimé
- Assigner une couleur quand la tâche est déplacée vers une colonne particulière
- Assigner une couleur à un utilisateur particulier
- Assigner automatiquement une couleur selon la catégorie
- Assigner automatiquement une catégorie en fonction d'une couleur
- Créer un commentaire depuis un fournisseur externe
- Créer une tâche depuis un fournisseur externe
- Ajouter un journal de commentaires quand on change une tâche de colonne
- Modifier l'assigné en fonction d'un nom d'utilisateur externe
- Modifier la catégorie en fonction d'une étiquette externe
- Mettre à jour automatiquement la date de début
- Déplacer la tâche vers une autre colonne quand la catégorie a changé
- Envoyer une tâche par mail à quelqu'un
- Modifier la couleur de la tâche quand on utilise un lien particulier pour cette tâche
Exemples
--------
Voici quelques exemples d'utilisation dans la vraie vie :
### Quand je déplace une tâche vers la colonne "Terminer", fermer automatiquement cette tâche
- Choisir l'action : **Fermer la tâche**
- Choisir l'évènement : **Déplacement d'une tâche vers une autre colonne**
- Définir le paramètre de l'action : **Colonne = Terminé** (c'est la colonne de destination)
### Quand je déplace une tâche vers la colonne "À valider", assigner cette tâche à un utilisateur particulier
- Choisir l'action : **Assigner la tâche à un utilisateur particulier**
- Choisir l'évènement : **Déplacer une tâche vers une nouvelle colonne**
- Définir les paramètres de l'action :**Colonne = À valider** et **Utilisateur = Adrien** (Adrien est par exemple un testeur)
### Quand je déplace une tâche vers la colonne "Travail en cours", assigner cette tâche à l'utilisateur courant
- Choisir l'action : **Assigner la tâche à la personne qui fait cette action**
- Choisir l'évènement : **Déplacer une tâche vers une autre colonne**
- Définir le paramètre de l'action : **Colonne = Travail en cours**
### Quand une tâche est terminée, dupliquer cette tâche vers un autre projet
Supposons que nous ayons deux projets : "Commande du client" et "Production". Une fois validée la commande, la basculer vers le projet "Production".
- Choisir l'action : **Dupliquer la tâche vers un autre projet**
- Choisir l'évènement : **Fermer une tâche**
- Définir les paramètres de l'action : **Colonne = Validé** et **Projet = Production**
### Quand une tâche est déplacée vers la toute dernière colonne, déplacer la même tâche exactement vers un autre projet
Supposons que nous ayons deux projets : "Idées" et "Développement". Une fois validée l'idée, la basculer vers le projet "Développement".
- Choisir l'action : **Déplacer la tâche vers un autre projet**
- Choisir l'évènement : **Déplacer une tâche vers une autre colonne**
- Définir les paramètres de l'action : **Colonne = Validé** et **Projet = Développement**
### Je veux assigner automatiquement une couleur à l'utilisateur Adrien
- Choisir l'action : **Assigner une couleur à un utilisateur particulier**
- Choisir l'évènement : **Modification de l'assigné à une tâche**
- Définir les paramètres de l'action :**Couleur = Vert** et **Assigné = Adrien**
### Je veux assigner automatiquement une couleur à la catégorie "Demande de fonctionnalité"
- Choisir l'action : **Assigner automatiquement une couleur à une catégorie particulière**
- Choisir l'évènement : **Création ou modification d'une tâche**
- Définir les paramètres de l'action : **Couleur = Bleu** et **Catégorie = Demande de fonctionnalité**
### Je veux régler automatiquement la date de début quand la tâche est déplacée dans la colonne "Travail en cours"
- Choisir l'action : **Mettre à jour automatiquement la date de début**
- Choisir l'évènement : **Déplacer une tâche vers une autre colonne**
- Définir les paramètres de l'action : **Colonne= Travail en cours**

34
doc/fr/budget.markdown Normal file
View File

@ -0,0 +1,34 @@
Gestion du budget
=================
La gestion du budget repose sur le suivi du temps d'une sous-tâche, l'emploi du temps de l'utilisateur et le taux horaire de l'utilisateur.
Cette section est accessible depuis la page de paramètres du projet : **Project > Budget**. Il existe également un raccourci depuis le menu déroulant sur le tableau.
Lignes budgétaires
------------
![Ligne des coûts](http://kanboard.net/screenshots/documentation/budget-lines.png)
Les lignes budgétaires sont utilisées pour définir le budget du projet.
Celui-ci peut être ajusté en ajoutant une nouvelle entrée avec une date effective.
Détail des coûts
--------------
![Détail des coûts](http://kanboard.net/screenshots/documentation/budget-cost-breakdown.png)
Selon le tableau qui donne le suivi temporel de la sous-tâche et les informations sur l'utilisateur vous pouvez voir le coût de chaque sous-tâche.
Le temps passé est arrondi au quart d'heure le plus proche.
Graphique du budget
------------
![Graphique du budget](http://kanboard.net/screenshots/documentation/budget-graph.png)
Finalement, en combinant toutes les informations nous pouvons générer un graphique :
- Les dépenses représentent le coût utilisateur
- Les lignes budgétaires sont le budget prévisionnel
- Le restant est le budget qui reste après un délai donné

20
doc/fr/calendar.markdown Normal file
View File

@ -0,0 +1,20 @@
Calendriers
========
il existe deux visualisations différentes des calendriers :
- La vue du projet avec des filtres (disponibles depuis le tableau)
- La vue utilisateur (disponible depuis le tableau de bord de l'utilisateur)
Pour l'instant le calendrier permet d'afficher les informations suivantes :
- Les tâches avec une date d'échéance, affichée en haut. **La date d'échéance peut être modifiée en déplaçant la tâche vers un autre jour**.
- les tâches basées sur la date de création ou la date de début. **Ces évènements ne peuvent pas être modifiés avec le calendrier**.
- Le suivi dans le temps de sous-tâches, tous les segments temporels sont affichés dans le calendrier.
- Les estimations pour les sous-tâches, les prévisions et le travail restant
![Calendrier](http://kanboard.net/screenshots/documentation/calendar.png)
La configuration du calendrier peut être modifiée dans la page des paramètres.
Remarque : la date d'échéance n'inclut pas d'information temporelle.

View File

@ -0,0 +1,32 @@
Créer des projets
=================
Kanboard peut gérer de multiples projets. Voici deux sortes de projets :
- Les projets multi-utilisateurs (pour le travail collaboratif, en équipe)
- Les projets privés, réservés à un seul utilisateur
Créer des projets multi-utilisateurs
-------------------------------------
- Seuls les administrateurs et administrateurs de projets peuvent créer ce type de projets
- La gestion des utilisateurs est disponible
Depuis le tableau principal, cliquez sur le lien **Nouveau projet** :
![Formulaire de création de projet](http://kanboard.net/screenshots/documentation/project-creation-form.png)
C'est vraiment très simple, il vous suffit de trouver un nom pour votre projet !
Créer un projet privé
--------------------------
- Tout le monde peut créer un projet privé
- Il n'y a **pas** de gestion des utilisateurs
- Seuls le propriétaire et les administrateurs peuvent accéder au projet
Depuis le tableau principal, cliquez sur le lien **Nouveau projet privé**.
![Nouveau projet privé](http://kanboard.net/screenshots/documentation/new-private-project.png)
Remarque : les noms de projets doivent être uniques dans toute l'application.

View File

@ -0,0 +1,16 @@
Modifier des projets
================
Les projets peuvent être renommés et désactivés à tout moment.
Pour renommer un projet, il suffit de cliquer sur le lien « Modifier un projet » sur la gauche.
![Modification de projet](http://kanboard.net/screenshots/documentation/project-edition.png)
- Les dates de début et de fin sont utilisées pour créer le diagramme de Gantt du projet
- La description est visible en infobulle sur le tableau et sur la page qui liste les projets
- Les administrateurs et administrateurs de projets peuvent convertir un projet privé en projet multi-utilisateur en décochant la case « Projet privé ».
- Vous pouvez également convertir un projet multi-utilisateur en projet privé.
Remarque : quand vous rendez un projet privé, tous les utilisateurs existants auront accès au projet. Ajustez la liste des utilisateurs selon vos besoins.

View File

@ -0,0 +1,17 @@
Diagramme de Gantt pour tous les projets
============================
Le but de ce diagramme de Gantt est d'afficher une vue d'ensemble de tous les projets basée sur les dates de début et de fin.
- Ce diagramme de Gantt est disponible dans la section de gestion du projet
- Seuls les administrateurs et administrateurs de projet peuvent accéder à cette section
- Les administrateurs de projet ne verront que les projets dans lesquels il y a des membres
- Les objets privés ne sont pas affichés dans ce graphique
![Diagramme de Gantt pour tous les projets](http://kanboard.net/screenshots/documentation/gantt-chart-all-projects.png)
- La **date de début** et la **date de fin** des projets est utilisée pour construire le graphique
- Les barres horizontales peuvent être redimensionnées et déplacées latéralement avec votre souris
- Il n'y a pas de glisser-déposer vertical
- Les barres de projet sont affichées en noir quand il n'y a ni date de début ni date de fin définies
- L'infobulle affiche la liste des gestionnaires de projets et les membres ordinaires

View File

@ -0,0 +1,20 @@
Diagramme de Gantt pour les tâches
======================
Le but de ce diagramme de Gantt est de montrer une vue d'ensemble du temps utilisé en fonction de l'ensemble des tâches d'un projet donné.
- Le diagramme de Gantt est disponible depuis le « sélecteur de vue »
- Seuls les gestionnaires de projet peuvent accéder à cette section
![Gantt Chart](http://kanboard.net/screenshots/documentation/gantt-chart-project.png)
- La **date de début** et la **date de fin** des tâches sont utilisées pour créer le graphique
- Les tâches peuvent être redimensionnées et déplacées horizontalement avec votre souris
- Il n'y a pas de glisser-déposer vertical
- La barre est de la même couleur que la tâche
- Chaque barre affiche un niveau de progression en pourcentage, qui est calculé en utilisant la position de la colonne dans le tableau
- Pour correspondre au modèle du Kanban, les tâches peuvent être ordonnées suivant leur position dans le tableau ou suivant les dates de début
- Les nouvelles tâches crées avec cette vue seront affichées sur le tableau en position 1 de la première colonne
- Les tâches sont affichées en noir quand il n'existe ni date de début ni date d'échéance définies
![Tâche non définie](http://kanboard.net/screenshots/documentation/gantt-chart-not-defined.png)

View File

@ -0,0 +1,49 @@
Permissions des projets
===================
Deux sortes d'utilisateurs sont en charge d'un projet : les **gestionnaires de projet** et les **membres du projet**.
- Les gestionnaires de projet peuvent gérer la configuration du projet et accéder aux rapports.
- Les membres du projet ne peuvent effectuer que des opérations de base (créer ou déplacer des tâches).
Quand vous créez un nouveau projet, le statut de gestionnaire de projet vous est automatiquement attribué.
Les administrateurs de Kanboard peuvent accéder à tout mais ils ne sont pas nécessairement gestionnaires de projet ni membres du projet. **Ces permissions sont définies au niveau du projet**.
Permissions selon chaque rôle
-------------------------
### Membres du projet
- Utiliser le tableau (créer, déplacer et modifier les tâches)
- Supprimer seulement les tâches créées par eux-mêmes
### Gestionnaires du projet
- Utiliser le tableau
- Configurer le projet
- Partager, renommer, dupliquer et désactiver le projet
- Gérer les swimlanes, les catégories, colonnes et utilisateurs
- Modifier les actions automatisées
- Exporter en CSV
- Supprimer les tâches de n'importe quel membre du projet
- Accéder à la section analytique
Ils ne **peuvent pas supprimer un projet**.
Gérer les utilisateurs et les permissions
----------------------------
Pour définir les rôles dans un projet, allez sur la page de **configuration de projet** puis cliquez sur **Gestion des utilisateurs**.
### Gestion des utilisateurs
![Permissions du projet](http://kanboard.net/screenshots/documentation/project-permissions.png)
C'est l'endroit où vous pouvez choisir de nouveaux membres, modifier leur rôle ou interrompre l'accès d'un utilisateur.
### Permission générale
Si vous choisissez d'autoriser tout le monde (tous les utilisateurs de Kanboard), le projet est considéré comme public.
Cela signifie qu'il n'y a plus de rôle de gestionnaire de projet. Les permissions par utilisateur ne peuvent pas s'appliquer.

View File

@ -0,0 +1,37 @@
Partager des tableaux et des tâches
========================
Par défaut, les tableaux sont privés, mais il est possible de rendre un tableau public.
Un tableau public ne **peut pas être modifié, il est en lecture seule**.
Son accès est protégé par un jeton aléatoire, seules les personnes qui ont la bonne URL peuvent voir le tableau.
Les tableaux publics sont automatiquement réactualisés toutes les minutes.
Les détails des tâches sont disponibles en lecture seule.
Exemples d'utilisation :
- Partager son tableau avec quelqu'un qui ne fait pas partie de votre organisation / entreprise / groupe
- Afficher le tableau sur un grand écran dans votre bureau
Activer l'accès public
-------------------
Choisissez votre projet, puis cliquez sur « Accès public » et enfin sur le bouton « Activer l'accès public ».
![Activer l'accès public](http://kanboard.net/screenshots/documentation/project-enable-sharing.png)
Lorsque l'accès public est activé, plusieurs liens sont créés :
- Affichage du tableau public
- Lien de souscription au fil RSS
- Lien d'abonnement à iCalendar
![Désactiver l'accès public](http://kanboard.net/screenshots/documentation/project-disable-sharing.png)
Vous pouvez désactiver l'accès public à tout moment.
À chaque fois que vous activez ou désactivez l'accès public, un nouveau jeton aléatoire est créé.
**Les liens précédents ne fonctionneront pas**.

28
doc/fr/swimlanes.markdown Normal file
View File

@ -0,0 +1,28 @@
Swimlanes
=========
Les *swimlanes* sont des séparations horizontales de votre tableau (pensez à des « couloirs » ou « lignes d'eau » dans une piscine).
Par exemple, cela peut servir à séparer les sorties des différentes versions d'un logiciel, à diviser vos tâches selon différents produits, équipes ou tout autre critère de votre choix.
Tableau avec des swimlanes
--------------------
![Configuration des swimlanes](http://kanboard.net/screenshots/documentation/swimlanes.png)
Gestion des swimlanes
------------------
- Tous les projets ont une swimlane par défaut.
- S'il existe plus d'une swimlane, le tableau les affichera toutes.
- Vous pouvez glisser-déposer les tâches d'une swimlane à l'autre.
Pour configurer les swimlanes allez sur la page de **Configuration du projet** et choisissez la section **Swimlanes**.
![Swimlanes Configuration](http://kanboard.net/screenshots/documentation/swimlanes-configuration.png)
À partir de cet endroit, vous pouvez ajouter une nouvelle swimlane ou renommer celle qui existe par défaut.
Vous pouvez aussi désactiver et modifier la position des diverses swimlanes.
- La swimlane par défaut est toujours en haut de tableau mais vous pouvez la cacher.
- Les swimlanes inactives ne sont pas affichées dans le tableau.
- **Supprimer une swimlane ne supprime pas les tâches qui lui sont assignées**, ces tâches seront transférées à la swimlane par défaut.