2010-11-04 18 views
0

Ma société comme beaucoup d'autres, nécessite une documentation dans le cadre du SDLC. Je ne suis pas contre, mais en tant que Premier ministre, je n'aime pas faire des choses qui n'ajoutent pas de valeur. Quel sera le bon mélange de détails pour un document de conception détaillée?Quelle est la bonne combinaison de détails dans une documentation de conception détaillée pour un projet logiciel?

À l'heure actuelle, il y a quelques personnes qui disent, mettons une capture d'écran, ajoutons quelques explications, mettons des requêtes SQL.

D'autres disent. Créons le code, puis créons les diagrammes de classes et d'autres UML.

Je n'ai jamais cru au code à l'intérieur des documents. C'est une contradiction en soi.

Quel sera ce bon mélange. Les meilleures pratiques à l'intérieur de notre société spécifient: Le diagramme de séquence, de classe et d'activité doit figurer dans tous les modèles de détail.

Merci pour l'aide. Géo

Remarque importante: Le projet sur lequel nous travaillons est un projet d'amélioration. Nous ajoutons des fonctionnalités et fonctionnalités, mais le logiciel n'est pas à partir de zéro.


NOTE1: Je pensais que le but principal d'une conception détaillée est de pouvoir remettre la conception à un développeur et le développeur sera en mesure de recréer le code. Plus l'aspect maintenance du code. Est-ce que je manque quelque chose?

Répondre

0

Ici (où je travaille) nous nous concentrons sur la communication avec les parties prenantes non-techniques du projet, en réalisant des wireframes pour chaque écran/rapport et en générant des diagrammes de flux de travail détaillés.

+0

Merci Paulo pour la réponse rapide. Que diriez-vous lorsque vous modifiez le code sur une fonctionnalité qui est le traitement back-end? Comment allez-vous représenter cela? – Geo

+0

Je documenterais le résultat attendu ainsi que les procédures de test et d'acceptation. La documentation devrait rester à l'écart des ressources d'ingénierie afin qu'ils puissent choisir la meilleure solution. –