Règles de conduite de projets
Après la première réunion :
- Rédaction d'un cahier des charges contenant :
- Le contexte du travail, le sujet
- Liste des travaux à effectuer : pour chaque tâche
- Type de travail (étude biblio., spécification, codage etc.)
- Matériel nécéssaire, compétence(s) à acquérir
- Donner les relations de dépendances entre les tâches
- Définir un groupe de travail pour chaque tâche et estimer la durée de chaque tâche (même très approximativement)
- Réaliser un calendrier prévisionnel du projet :
- Lister les tâches et les groupes
- Lister les disponibilités
- Dessiner le calendrier
Après chaque réunion : rédaction d'un compte rendu
- Date
- Participants
- Liste des points abordés, avec pour chacun :
- Motif de la discussion
- Etat d'avancement par rapport au calendrier
- Ajustement éventuelle du calendrier
- Conclusion
- Conclusion :
- Commentaires d'ensemble
- Mise a jour du calendrier prévisionnel
Avant chaque réunion :
- Prévoir un ordre du jour (liste des points à aborder)
- Préparer les documents :
- Compte rendu précédent
- Cahier des charges
- Calendrier prévisionnel avec disponibilités de chacun
A la fin du projet :
Faire une archive (tgz) contenant :
- Un fichier texte (pas de .doc !) «README.TXT» donnant le contenu de l'archive, le sujet , etc.
- Tous les documents cités ici : rapports, spécifications, etc.
- Les fichiers sources et compilés convenablement organisés dans des sous-répertoires
- Le ou les fichiers de présentation utilisés pendant la soutenance
Règles de réalisation du projet
Spécification :
Avant tout codage il est indispensable de faire un document de spécification comportant :
- Le point de départ :
- Ce qui existe (pgm., projet...) et ce que l'on veut faire (tâche précédemment définie)
- Fonctions/bibliothèques disponibles
- Structure de données (exemple : codage d`une image dans un tableau d'entier allant de 0 à 255...)
- Proposer une solution à l'aide de phrases en français : le but est aussi de pouvoir discuter/présenter cette solution :
- Décomposer le problème à résoudre en petites parties
- Donner les relations entre ces parties
- Proposer une « structure logiciel » de la solution (relations entre différentes parties définies précédemment)
- Transformer cette solution en pseudo-langage correspondant aux choix structurels précédent : discuter/présenter
- Coder cette solution dans le langage le plus adapté au problème en suivant les quelques règles suivantes
Codage :
- Outils de développement/bibliothèques
- Outils utilisés : emplacement (site ftp etc) des archives, et commentaires sur l'installation des outils (si ils étaient installés : le dire et donner la version de chacun)
- Idem pour les bibliothèques
- Les noms de fichier doivent avoir une signification par rapport à leur contenu
- Pour chaque fonction créée :
- Donner un nom significatif par rapport à son rôle
- Avant de coder la fonction : donner le rôle de cette fonction ainsi que les éventuelles bibliothèques spécifiques (personnelles ou non) utilisées par cette fonction
- Indiquer ce qu'elle prend en entrée (y compris les variables globales éventuelles si elles n'ont pu être évitées) : Type des données et commentaire sur la signification de ces données
- Indiquer ce qu'elle produit idem que pour les entrées-
- Choisir des noms de variables significatif etc.
NE PAS COMMENTER UNE FOIS QUE CELA FONCTIONNE MAIS PENDANT LE DEVELOPPEMENT