Documenter Ou comment partager la connaissance

Documenter

• Ou comment partager la connaissance

Plan

• Cycle de dévt logiciel

• Typologie des documents

• Technique pour rédiger des documents

• Qu’est-ce qu’une représentation?

Cycle de vie du logiciel

Règle de transformation

• Seule la dernière étape est réalisée systématiquement dans le langage adapté (C++, Visual Basic, PHP, SQL, …) ;

• Pourtant

• Chaque activités (étapes) du développement a ses techniques ;
• Il existe des langages, des notations adaptés à chacune de ces transformations.

Le jeu des questions

• Définition du problème

• Pourquoi

• Analyse

• Quoi

• Conception

• Comment

Typologie des documents

• Définition du problème, capture des besoins

• Dossier de Spécifications Générales (externes)

• Analyse

• Dossier de Spécifications Détaillées (internes)

• Conception

• Dossier de Conception Générale
• Architecture
• Dossier de Conception Détaillée
• Détail chaque module

DSG : plan-type

• Contexte

• Audience, Glossaire

• Description Générale

• Objectif du système
• Fonctions principales
• Contraintes générales
• Caractéristiques des acteurs

• Besoins détaillés

• Spécifications fonctionnelles
• Spécifications opérationnelles

Qu’est-ce qu’un objectif ?

Qu’est-ce qu’une contrainte ?

Contraintes : exemple

• Contraintes architecturales

• Caractéristiques des machines cibles, OS, …

• Environnementale,

• Nombre de sites,

• Contrainte de déploiement

• Reprise de l’existant

Qu’est-ce qu’un acteur ?

• Voir le support « Modèle d’usage »

Spécifications fonctionnelles

• Voir le support « Notation IDEF0 »

Spécifications opérationnelles

• Typologie

• Performances
• L’ADS doit être renvoyé en moins de 10s
• Volumétrie
• Traiter 500 000 TDs / an
• Maintenance
• Le système est surveillé 24h/24, les jours ouvrables
• Sureté de fonctionnement
• Intégrité, disponibilité du système, fiabilité, …
• Confidentialité
• Lister les profils et leur prérogatives