Projet

Général

Profil

Wiki » Historique » Version 15

Gérald Schwartzmann, 30/09/2013 15:18

1 6 Gérald Schwartzmann
h1. La documentation officielle
2 6 Gérald Schwartzmann
3 1 Redmine Admin
Les documentations officielles sont disponibles aux adresses suivantes :
4 1 Redmine Admin
5 6 Gérald Schwartzmann
Accès direct au répertoire contenant la documentation : http://eole.orion.education.fr/documentations
6 1 Redmine Admin
7 8 Gérald Schwartzmann
h1. La documentation non officielle (contributive)
8 6 Gérald Schwartzmann
9 1 Redmine Admin
Vous pouvez trouver quelques documentations dans l'onglet "Documents" de chaque projet Redmine.
10 8 Gérald Schwartzmann
Ces documents peuvent être des contributions et ne sont pas toutes maintenues par l'équipe EOLE.
11 6 Gérald Schwartzmann
12 6 Gérald Schwartzmann
h1. Contribuer à la documentation
13 6 Gérald Schwartzmann
14 6 Gérald Schwartzmann
h2. Faire un signalement
15 6 Gérald Schwartzmann
16 6 Gérald Schwartzmann
Vous pouvez signaler des coquilles, faire des demandes d'amélioration ou d'ajout dans la documentation en vous rendant dans l'onglet "Demandes" du présent projet : 
17 6 Gérald Schwartzmann
http://dev-eole.ac-dijon.fr/projects/documentations/issues
18 6 Gérald Schwartzmann
19 6 Gérald Schwartzmann
h2. Proposer de la documentation
20 6 Gérald Schwartzmann
21 6 Gérald Schwartzmann
Vous pouvez proposer vos documentations, elles seront soient intégrées dans la documentation officielle ou mise à disposition dans l'onglet "Documents" du projet Redmine approprié.
22 6 Gérald Schwartzmann
Vous pouvez nous faire parvenir la documentation sur les listes ou à l'adresse de contact de l'équipe EOLE.
23 6 Gérald Schwartzmann
24 15 Gérald Schwartzmann
h2. Pour les développeurs et les rédacteurs
25 6 Gérald Schwartzmann
26 6 Gérald Schwartzmann
h3. Les bonnes pratiques
27 1 Redmine Admin
28 15 Gérald Schwartzmann
Rendre la doc la plus générique possible.
29 15 Gérald Schwartzmann
Évitez au maximum les numéros de version qui rendent les mises à jour monstrueuse.
30 15 Gérald Schwartzmann
La documentation se doit de respecter au mieux les conventions typographiques.
31 1 Redmine Admin
32 15 Gérald Schwartzmann
Vous pouvez retrouver celles-ci dans la documentation :
33 15 Gérald Schwartzmann
34 15 Gérald Schwartzmann
* directement dans SCENARI lorsque vous éditez la documentation
35 15 Gérald Schwartzmann
* en HTML à l'adresse http://eoleng.ac-dijon.fr/documentations/2.3/partielles/HTML/Documentation/
36 15 Gérald Schwartzmann
* en PDF à l'adresse http://eoleng.ac-dijon.fr/documentations/2.3/partielles/PDF/Documentation.pdf
37 15 Gérald Schwartzmann
38 1 Redmine Admin
h3. Installation de ScenariClient
39 10 Gérald Schwartzmann
40 10 Gérald Schwartzmann
Il existe un tutos sur l'installation de ScenariClient accessible en interne sur le samba de l'équipe.
41 15 Gérald Schwartzmann
L'installation est également décrite dans la documentation.
42 13 Laurent Flori
43 9 Gérald Schwartzmann
h3. Cycle de publication
44 9 Gérald Schwartzmann
45 11 Gérald Schwartzmann
Généralement une partie de la documentation est rédigée pendant la période de stabilisation des paquets, entre l'état candidat et l'état publié.
46 9 Gérald Schwartzmann
Lorsque les demandes sont passées à résolu elles nécessite une relecture par un tier pour ensuite être fermées.