Documenter son programme?

Documenter son programme? - C - Programmation

Marsh Posté le 09-10-2003 à 13:20:42    

:hello:  
 
Comment faites vous la doc de vos programmes? (si vous en faites  :whistle:)
 
je m'explique je bosse sur un projet en C et il faut q je fasse une doc, voire plus (these)
 
UML ne me parait pas trop adapté vu q c pas de la programmation objet.
 
en fait je cherche un moyen de "schématiser" l'organisation de mon programme: structures des données, process, threads, echanges de données entre tt ca...
 
avez vous qqch a me recommander? g pas trouver grd chose dans les topics de liens...

Reply

Marsh Posté le 09-10-2003 à 13:20:42   

Reply

Marsh Posté le 09-10-2003 à 13:56:00    

UML, c'est pas que de la POO. En d'autres termes, tu n'as pas que le diagramme de classes, mais aussi le diagramme de séquence, le diagramme d'utilisation, et d'autres dont je ne me souviens plus.
UML reste donc un bon moyen d'exprimer pas mal de chose.
Dans le même genre, il existe aussi Merise, mais là je me souviens plus trop ...


Message édité par bobuse le 09-10-2003 à 13:56:20
Reply

Marsh Posté le 09-10-2003 à 14:12:41    

bobuse a écrit :

UML, c'est pas que de la POO. En d'autres termes, tu n'as pas que le diagramme de classes, mais aussi le diagramme de séquence, le diagramme d'utilisation, et d'autres dont je ne me souviens plus.
UML reste donc un bon moyen d'exprimer pas mal de chose.
Dans le même genre, il existe aussi Merise, mais là je me souviens plus trop ...


Merise devrait tout à fait être adapté.
 
Y'a le DAF qui permet d'illustrer les flux de façon très schématique et simpliste.
Le MCT et MOT qui vont te permettre de schématiser l'agencement des traîtemts, les règles de gestions etc.
Le MCD et MPD qui vont te permettre de schématiser la structure des données.
 
Mais très clairement, ça s'arrête pas là. Ces schéma plus descriptions ça représente 10% à tout casser. Après t'as ce qui s'appelle la doc... Déjà t'as plusieur docs...
Cahier des charges, rapport d'analyse (ce qui va contenir les schéma), documentation technique, manuel utilisateur, les doc How To et Troubleshot, etc.
 

Reply

Marsh Posté le 09-10-2003 à 14:23:36    

ok, merci pour ces infos, je v creuser ca.
 
j'ai trouvé ArgoUML qui a l'air pas trop mal et je v voir ce q je peux faire avec ca.
 
quant a Merise, j'ai trouvé qq pages à ce sujet. Du made in France (Cocoricoo!!), les diagrammes me plaisent bien, je v voir aussi mais vu q je fais la these en anglais (je suis en Finlande) je v pe rester en UML :/
 
 
d'autres avis?
 
 
edit: le type de doc q'il faut q je fasse est principalement ce q tu cites comme cahier des charges et rapport d'analyse, à la rigueur doc technique mais le reste est secondaire


Message édité par xmulder le 09-10-2003 à 14:29:54
Reply

Marsh Posté le 09-10-2003 à 14:56:16    

ArgoUML a été un peu abandonné. Maintenant c'est poseidon (payant, mais version d'evaluation renouvelable :ange: ) qui a pris la relève. Et ça marche pas trop mal (on en a déjà parlé dans d'autres topics ...)

Reply

Marsh Posté le 09-10-2003 à 15:22:07    

abandonné?? la version q g trouvé date de aout2003  
 
t'as une url pour poseidon? (portabilité? je suis sous nux)

Reply

Marsh Posté le 09-10-2003 à 16:01:10    

www.gentleware.com
 
niveau portabilité c'est comme argoUML -> java natif
 
ya 1 an et demi, ca avait l'air abandonné et poseidon valait plus le coup, mais ptet kil y a eu un renversement de situation ... gasp !

Reply

Marsh Posté le 09-10-2003 à 19:57:54    

xmulder a écrit :

ok, merci pour ces infos, je v creuser ca.
 
j'ai trouvé ArgoUML qui a l'air pas trop mal et je v voir ce q je peux faire avec ca.
 
quant a Merise, j'ai trouvé qq pages à ce sujet. Du made in France (Cocoricoo!!), les diagrammes me plaisent bien, je v voir aussi mais vu q je fais la these en anglais (je suis en Finlande) je v pe rester en UML :/
 
 
d'autres avis?
 
 
edit: le type de doc q'il faut q je fasse est principalement ce q tu cites comme cahier des charges et rapport d'analyse, à la rigueur doc technique mais le reste est secondaire


 
c'est normal, Merise c'est francais...

Reply

Marsh Posté le 09-10-2003 à 20:38:19    

ToxicAvenger a écrit :


 
c'est normal, Merise c'est francais...


 
oui, c ce q je veux dire...

Reply

Sujets relatifs:

Leave a Replay

Make sure you enter the(*)required information where indicate.HTML code is not allowed