Merge pull-request #1222

11 files changed, 460 insertions, 0 deletions

diff --git a/doc/fr/analytics.markdown b/doc/fr/analytics.markdown
new file mode 100644
index 00000000..951ade04
--- /dev/null
+++ b/doc/fr/analytics.markdown
@@ -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)
diff --git a/doc/fr/automatic-actions.markdown b/doc/fr/automatic-actions.markdown
new file mode 100644
index 00000000..844354a5
--- /dev/null
+++ b/doc/fr/automatic-actions.markdown
@@ -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**
diff --git a/doc/fr/budget.markdown b/doc/fr/budget.markdown
new file mode 100644
index 00000000..3eac20d5
--- /dev/null
+++ b/doc/fr/budget.markdown
@@ -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é
diff --git a/doc/fr/calendar.markdown b/doc/fr/calendar.markdown
new file mode 100644
index 00000000..94610efb
--- /dev/null
+++ b/doc/fr/calendar.markdown
@@ -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.
diff --git a/doc/fr/creating-projects.markdown b/doc/fr/creating-projects.markdown
new file mode 100644
index 00000000..d492ac62
--- /dev/null
+++ b/doc/fr/creating-projects.markdown
@@ -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.
diff --git a/doc/fr/editing-projects.markdown b/doc/fr/editing-projects.markdown
new file mode 100644
index 00000000..67f8a0db
--- /dev/null
+++ b/doc/fr/editing-projects.markdown
@@ -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.
+
diff --git a/doc/fr/gantt-chart-projects.markdown b/doc/fr/gantt-chart-projects.markdown
new file mode 100644
index 00000000..f2ac40ac
--- /dev/null
+++ b/doc/fr/gantt-chart-projects.markdown
@@ -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
diff --git a/doc/fr/gantt-chart-tasks.markdown b/doc/fr/gantt-chart-tasks.markdown
new file mode 100644
index 00000000..73053ed2
--- /dev/null
+++ b/doc/fr/gantt-chart-tasks.markdown
@@ -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)
diff --git a/doc/fr/project-permissions.markdown b/doc/fr/project-permissions.markdown
new file mode 100644
index 00000000..9e21e1ad
--- /dev/null
+++ b/doc/fr/project-permissions.markdown
@@ -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.
diff --git a/doc/fr/sharing-projects.markdown b/doc/fr/sharing-projects.markdown
new file mode 100644
index 00000000..0d2df7aa
--- /dev/null
+++ b/doc/fr/sharing-projects.markdown
@@ -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**.
+
+
diff --git a/doc/fr/swimlanes.markdown b/doc/fr/swimlanes.markdown
new file mode 100644
index 00000000..48772117
--- /dev/null
+++ b/doc/fr/swimlanes.markdown
@@ -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.