Discussion :

[-Fly-]

Bonjour,

Voila je suis en stage informatique première année et j'ai un projet a faire qui consiste a afficher dans un page php des remontée d'information issus d'un SI . En plus du codage je dois fournir de la doc, le problème est que je ne sais pas vraiment quoi mettre dans la partie spécification. Que faut il mettre exactement ? des aspects techniques ? globaux ?

[hegros]

Spécification est un mot qui recouvre pleins de choses je pense donc aux

Spécification système
Spécification fonctionnelle
Spécification technique
Spécification des tests
Spécification non fonctionnelle (de performance)
Spécification de la sécurité et de la confidentialité
Spécification des écrans
...

[dba01]

On m'a demandé un doc un jour. Le patron, pas informateux pour deux ronds, voulait savoir "ça sert à quoi votre truc ?", les utilisateurs voulaient connaître toutes les manips, les DBA s'inquiétaient des conséquences dans leur système, et les programmeurs voulaient tous les formats d'écrans, de tables, de filtres, de traitements et d'horaires. Rien qu'en explications, descriptions et mode d'emploi, sans les traitement réels, j'avais déjà 100 pages.

Imagine qu'il s'agisse de m'expliquer le machin à moi, qui ne suis qu'un amateur à côté de vous : c'est quoi ce truc, pourquoi faire, fais voir, ça contient quoi, tout, tout, tout.

Bon courage. La doc c'est aussi chiant que les écrans.
.db.