Projet

Général

Profil

Je veux utiliser un projet existant » Historique » Version 3

Christian Bulfone, 24/06/2016 14:37

1 2 Damien Roque
h1. Redmine pour les utilisateurs
2 1 Damien Roque
3 2 Damien Roque
h2. Mise en forme du texte
4 1 Damien Roque
5
Redmine utilise le langage _Textile_ pour mettre en forme le texte dans la plupart des zones de saisie. Ce langage faiblement typé est relativement intuitif, mais certaines de ses fonctionnalités avancées sont décrites ci-dessous.
6
* La documentation officielle du langage Textile utilisé dans Redmine est disponible ici : http://www.redmine.org/projects/redmine/wiki/RedmineTextFormatting.
7
* Le plugin Wiking permet d'étendre les possibilités du langage, tel que décrit ici : http://projects.andriylesyuk.com/projects/wiking/wiki/Syntax.
8
* Le plugin MathJax permet d'écrire des expressions mathématiques avec la syntaxe LaTeX : par exemple @$\sum_i x_i$@ donne $\sum_i x_i$.
9
10 2 Damien Roque
h2. Bonnes pratiques pour la rédaction du wiki
11 1 Damien Roque
12 2 Damien Roque
{TODO}
13
14
h2. Bonnes pratiques pour la gestion des tickets
15
16
Le gestionnaire de tickets permettent la formalisation de travaux de nature variée : tâches, demandes, actions, évolution, compte rendu...  Ces différents travaux ont les points communs suivants :
17
* ils sont localisés dans le temps avec une date de début et souvent une date d'échéance ;
18
* ils sont localisés dans l'équipe projet dans la mesure où un ticket ne peut être assigné qu'à une seule personne (avec éventuellement des observateurs qui seront notifiés de son évolution) ;
19
* ils contiennent un état qui témoigne de leur cycle de vie (nouveau, en cours, résolu...) ainsi qu'un indicateur de complétion.
20
21
En fonction de la nature des travaux (trackers), les tickets peuvent faire apparaître différents champs supplémentaires qui permettent de structurer au mieux l'information. Par exemple, un compte rendu de réunion fera apparaître les noms des personnes présentes alors qu'un rapport d'anomalie ne comportera pas un tel champ. Un tel formatage imposé permet ensuite de retrouver facilement les tickets dans un projet donné.
22
23
Le gestionnaire de ticket permet de suivre le déroulement des travaux, en conservant l'historique et la traçabilité des modifications, en établissant des relations entre les différents tickets, en assurant la notification par courriel des utilisateurs concernés.
24
25
L'objectif des tickets est de faciliter le partage des informations liées à la gestion du projet entre les membres de l'équipe. Cela nécessite toutefois le respect de certaines règles et bonnes pratiques...
26
27
* Tous les champs d'un tickets doivent être remplis le plus précisément possible.
28
* Les tickets doivent traiter de travaux élémentaires, c'est à dire dont la durée doit être la plus courte possible.
29
* Durant leur cycle de vie, les tickets doivent évoluer pour refléter la réalité du travail accompli (complétion, assignation...).
30
* Les tickets peuvent faire référence à d'autres objets de l'espace de travail collaboratif (ex. : pages de wiki, documents, fichiers, annonces, gestionnaire de code source...), il faut favoriser la navigation hypertexte. Au besoin, consulter l'aide en ligne de l'éditeur afin de réaliser ces liens.
31
32
h2. Utilisation des dépôts de code source
33
34
h3. Adresses des dépôts
35
36
Lorsqu'un projet dispose d'un dépôt de code source, son adresse est sous la forme :
37 1 Damien Roque
<pre>
38 3 Christian Bulfone
https://<type>.gipsa-lab.grenoble-inp.fr/<nom-depot>.git|<nom-depot>
39 1 Damien Roque
</pre>
40 2 Damien Roque
41
* @<type>@ est à remplacer par @svn@ ou @git@ en fonction du dépôt créé ;
42
* @<nom-depot>@ est à remplacer par l'identifiant donné au dépôt.
43
Ces deux éléments doivent être fournis par le créateur du dépôt ; il est recommandé de les faire figurer dans le wiki du projet.
44 1 Damien Roque
45 2 Damien Roque
h3. Utilisation de SVN
46
47 1 Damien Roque
Pour apprendre à utiliser SVN, il est recommandé de lire "cette page":https://ensiwiki.ensimag.fr/index.php/Subversion. Les principales commandes sont synthétisées dans une "refcard":http://www.digilife.be/quickreferences/QRC/Subversion%20Quick%20Reference%20Card.pdf.
48
49 2 Damien Roque
h3. Utilisation de Git
50 1 Damien Roque
51 2 Damien Roque
Plusieurs bons tutoriel tels que "celui-ci":https://fr.atlassian.com/git/tutorials/setting-up-a-repository ou "celui-là":http://backlogtool.com/git-guide/en/intro/intro1_1.html permettent de prendre en main Git rapidement. Cela dit, l'outil reste beaucoup plus puissant et beaucoup plus difficile à manier que SVN. Ne pas hésiter à se référer à sa "documentation officielle":http://git-scm.com/doc en cas de besoin. Pour un perçu des principales commandes, on peut aussi imprimer cette "refcard":https://training.github.com/kit/downloads/github-git-cheat-sheet.pdf.
52 1 Damien Roque
53 2 Damien Roque
h2. Goodies
54
55
h3. Les notifications par courriel et par flux Atom
56
57
{TODO}
58
59
h3. Les avatars
60
61 1 Damien Roque
Il est possible d'utiliser un avatar sous Redmine, mais à première vue ce n'est pas dans la rubrique _Mon compte_ que cela se passe. En fait, la plate-forme n'héberge pas les avatars des utilisateurs, ces derniers sont téléchargés à la volée à partir de Gravatar. Voici comment procéder...
62
63 2 Damien Roque
# Sélectionner une photo d'identité ou se créer un avatar, par exemple en utilisant http://www.faceyourmanga.com.
64
# Se créer un compte sur https://en.gravatar.com en mentionnant l'adresse e-mail utilisée sous Redmine (voir dans la rubrique _Mon compte_), puis charger l'avatar créé précédemment.