Discussion :

[pepitoluna]

Bonjour,
Je suis actuellement dans une boite ou il n'existe aucune documentation technique (spécifications fonctionnelles techniques ....).
Cette boite a plusieurs grosses applications s'appuyant sur une partie métier assez complexe (850 tables, bcp de procédures pl/sql,etc..) ou rien n'est renseigné. La transmission d'information au sujet des tables, des process se fait exclusivement par voie orale.... donc assez limité.
Cette société construit elle-même ses progiciels et j’ai l’impression qu’ils ne veulent pas perdre du temps à faire une vraie documentation ... le problème est qu’ils en perdent beaucoup du moins avec les nouveaux prestataires qu’ils intègrent pour la partie développement…
Mon problème, vous l’aurez donc compris est que je passe énormément de temps à chercher à comprendre le fonctionnement de certains process, des tables, etc.et donc n’ayant pas beaucoup d’expérience je me demandais si c'était un problème récurrent que l'on pouvait rencontrer ailleurs.
Du coup, je me suis aussi interroger sur l'importance de la modélisation de manière générale dans la conception des documents techniques servant à la maintenance d'un progiciel et sur la manière de leur faire comprendre l'utilité d'une bonne documentation technique.
Autre point, j'ai essayé d’en discuter un peu avec le responsable développement qui m’a avoué qu’il ne savait pas trop comment construire cette documentation technique ni comment la mettre en place ( doc en ligne, etc), si vous aviez des exemples à partager.
Merci

[Tidus159]

Bonjour,

c'est une excellente question qui touche à la "gestion de la connaissance" (y'a pas mal de doc de ce concept sur internet). Malheureusement en entreprise le temps manque pour faire des conceptions détaillées (sauf MCD ou diagramme de classe). Le code applicatif est souvent la documentation de dernier recours...
Une GED est quasiment indispensable si tu veux gérer la documentation.
Pour mettre en place les documentations utilisateurs et spécifications fonctionnels, il suffit d'avoir un traitement de texte et un méthode =>
- Un titre
- Un numéro de version
- un tableau recensant les numéro de version et les modifications effectuées
- Une bonne structure de document qui soit "générique" (même si toutes les rubriques ne sont pas toujours utilisées).

Je pense qu'en cherche un peu sur internet, tu vas trouver des exemples...

@+