Discussion :

[soa]

Bonsoir

Voilà je voulais savoir si vous pouviez me conseiller un bouquin ou site web, qui m'aiderai à déterminer quel genre de rapport/documentation et comment les structurer, sont à rédiger lors de conception/développement de logiciel généralement.

C'est vraiment pas mon point fort.

je vous remercie.

[hegros]

Je te rassure tout de suite, la documentation en développement ce n'est le point fort de personne !

D'ailleurs certaines approches ou best practises (gxp médecine) recommande de ne pas documenter du tout !

[soa]

Sauf que là c'est éviter le problème, ce n'est pas une solution. D'autant plus que parfois c'est pas toi qui décide, t'as pas le choix, enfin bref.

[hegros]

Si quelqu'un a décider pour toi normalement il ne devrait pas y avoir de problème puisqu'il a probablement pondu un plan documentaire, pour toi il suffira de le suivre.


Aussi cela dépend de ta fonction dans l'entreprise, un documentaliste et un développeur ne documente pas de la même façon et n'y passe pas le même temps.


Si tu as déjà une conception finie alors générer le plan documentaire ne devrait pas être difficile puisqu'il devra la contenir, la structuration ira de pair avec la structuration de la conception.

désolé je ne connais ni livre ni site qui m'a aidé la dessus et pour mon expérience dans 80% des cas la documentation était inutile, incomplète ou fausse.

[lepinekong]

Si quelqu'un a décider pour toi normalement il ne devrait pas y avoir de problème puisqu'il a probablement pondu un plan documentaire, pour toi il suffira de le suivre.

Ouaih ça se résume à : "Tiens selon le PQA n°XYZ il faut que tu me sortes la doc qui correspond au template TXYZ, il y a les titres et des explications en bleue, t'as qu'à suivre".

Et en ouvrant le template en question, tu t'aperçois que c'est plein de généralités

De deux choses l'une: soit tu remplis les cases superficiellement sachant que de toute façon il y a de grandes chances que les gens en charge du contrôle ne savent vérifier que la forme et non le fond, soit tu le fais sérieusement mais alors ça te prends un temps fou pour un boulot qui ne sera pas forcément récompensé. Donc intelligemment t'essayes de faire un compromis en remplissant ce qui va vraiment servir dans la pratique. Pour le reste tu fais copier-coller.

[robert_trudel]

Bonsoir

Voilà je voulais savoir si vous pouviez me conseiller un bouquin ou site web, qui m'aiderai à déterminer quel genre de rapport/documentation et comment les structurer, sont à rédiger lors de conception/développement de logiciel généralement.

C'est vraiment pas mon point fort.

je vous remercie.

regarde du côté de rational rose, ils ont des templates pour ça
il y a aussi le IEEE qui a des documents

autrement regarde le SWEBOK