par
mere-teresa » 04 mai 2006, 10:08
Bah, ça doit répondre à ta question, ne confonds pas tout, s'il te plaît 
Si c'est destiné à des gens qui devront savoir modifier l'application, ils aimeront trouver des informations
- sur le stockage des données (fichiers ? SGBD ?)
- sur l'architecture (organisation des répertoires, flux de données entre les programmes)
- le parcours utilisateur (quelle action déclenche quel retour, comment accède-t-il à ses données ?)
- le contenu des programmes (quel programme traite quelle partie de l'application ? Si je veux modifier telle fonctionnalité, dans quel fichier vais-je chercher ?).
Pour ma part, mes documentations contiennent la partie technique le schéma de la BDD, l'architecture (description arborescence et contenu répertoire), un tableau à 3 colonnes (nom du fichier, rôle, contenu) qui liste les fichiers par répertoire et par nom, avec leur rôle et les objets, méthodes et fonctions qui sont dedans, et un schéma UML avec les acteurs et leurs actions (les petits bonshommes), et la partie fonctionnelle : le schéma UML aussi, un joli schéma du parcours utilisateur, et un joli schéma du même parcours avec les noms de fichiers.
Si c'est destiné à des gens qui installeront l'application, ils voudront savoir la configuration à adopter, pour le serveur, les pré-requis (PHP4 ? PHP5 ? GD ?...etc), les actions à faire étape par étape (installation serveur, création bases de données, copie des fichiers, modifications des droits sur les répertoires, etc...)
[color=darkblue]Bah, ça doit répondre à [b]ta [/b]question, ne confonds pas tout, s'il te plaît :)
Si c'est destiné à des gens qui devront savoir modifier l'application, ils aimeront trouver des informations
- sur le stockage des données (fichiers ? SGBD ?)
- sur l'architecture (organisation des répertoires, flux de données entre les programmes)
- le parcours utilisateur (quelle action déclenche quel retour, [i]comment accède-t-il à ses données ?[/i])
- le contenu des programmes (quel programme traite quelle partie de l'application ? [i]Si je veux modifier telle fonctionnalité, dans quel fichier vais-je chercher ?[/i]).
Pour ma part, mes documentations contiennent [b]la partie technique [/b]le schéma de la BDD, l'architecture (description arborescence et contenu répertoire), un tableau à 3 colonnes (nom du fichier, rôle, contenu) qui liste les fichiers par répertoire et par nom, avec leur rôle et les objets, méthodes et fonctions qui sont dedans, et un schéma UML avec les acteurs et leurs actions (les petits bonshommes), [b]et la partie fonctionnelle[/b] : le schéma UML aussi, un joli schéma du parcours utilisateur, et un joli schéma du même parcours avec les noms de fichiers.
Si c'est destiné à des gens qui installeront l'application, ils voudront savoir la configuration à adopter, pour le serveur, les pré-requis (PHP4 ? PHP5 ? GD ?...etc), les actions à faire étape par étape (installation serveur, création bases de données, copie des fichiers, modifications des droits sur les répertoires, etc...)[/color]
