Combien de temps consacrez-vous au document de conception (s) pour votre logiciel?

Question

Il est évident que la taille du projet sur lequel vous travaillez sera un facteur énorme dans combien de temps vous passez la rédaction du document de conception / spécification. Mais vous allez à travers tout, choisissant chaque petit détail? Ou est-ce que vous prenez une approche plus agile et commencer à écrire le logiciel assez tôt et de résoudre les problèmes comme ils viennent à vous?

J'ai toujours trouvé qu'il n'y a que dans la mesure, vous pouvez aller à la conception. Il y aura inévitablement des choses qui ne sont pas atteints et à ce moment-là à quel point vous pouvez adapter aux moyens situation plus que la spécification elle-même.

Suis-je prendre le bon point de vue à ce sujet? Est-ce réellement une opinion, ou est une spécification de conception parfaite toujours le meilleur itinéraire pour aller?

Answer 1

Cela dépend un peu de votre public cible, mais mon expérience (plus petite / moyenne développement à grande échelle que le travail à très grande échelle) est que les documents de conception détaillés sont pénibles et ennuyeux à écrire, rarement lu et ont tendance à se retrouver sur la date au moment où un projet est livré.

Cela ne veut pas dire qu'ils ne valent rien - si vous livrez quelque chose pour quelqu'un, il doit y avoir une déclaration officielle et convenue de ce qui sera livré suffisamment détaillé que tout le monde peut pointer vers elle au cas où quelqu'un est mécontent de l'affaire et dire « voici ce que nous avons promis » et évaluer contre ce qui a été livré.

Si j'établissions une entreprise pour construire un produit, cependant, je ne vous inquiétez pas tant sur une spécification détaillée. Je voudrais le document ce nous allions faire, mais je ne voudrais pas entrer dans trop de profondeur en ce qui concerne comment - qui est la partie qui est le plus susceptible de changement et laisser les documents à jour et assez inutile, voire inexact d'être effectivement obstructive. Je préfère documenter le « comment » des choses dans le code en utilisant tout format de documentation du soutien linguistique ou IDE meilleur, de sorte que le code change, il est plus facile de mettre à jour la documentation en même temps. Il ne l'arrêtera pas sortir de ce jour, mais il réduire quelque peu.

Idéalement, vous voulez un document serait de conception qui pourrait doubler comme votre manuel lorsque votre code est complet, mais je ne connais personne qui a réussi avec succès que.

Answer 2

Cela dépend vraiment de la taille et de la structure du projet.

Pour les projets clients, les spécifications détaillées sont un must. J'aime impliquer fortement le client lors de la spécification de conception. Cela aide à éliminer les considérations supplémentaires et donne au client une meilleure compréhension de ce qu'il faut attendre. Il y a habituellement un changement positif dans l'attitude (à temps et prix) après la découverte et les spécifications sont complètes. Cela nous permet également de jalons fixés - et les a frappés -. Ce qui est favorable pour le client, et notre équipe de développement

Pour les projets internes et projets parallèles amusants, je crée généralement un organigramme et liste des fonctionnalités, puis commencer à bidouiller ensemble. Dans ces cas, ce que je trouve plus important qu'une fiche technique de fonction, est l'interface utilisateur réelle. Je wireframe le site sur le papier et faire un simple construction de l'interface utilisateur (html / css). Cela me aide à penser à travers l'expérience utilisateur, que je plus de valeur que les caractéristiques spécifiques sur mes propres projets. Je peux toujours revenir en arrière et la pièce comporte ensemble plus tard.

Answer 3

Cela dépend ce que vous entendez par des documents de conception.

Je passe 1/3 à 1/2 de mon temps à écrire vers le bas pour l'écriture des dessins I logiciel, dans un livre de notes, esquissant les choses, déterminer des algorithmes, des relations, des histoires, etc.

Je ne fais pas tout cela avant vers le haut.

Je n'ai pas un document principal signé et scellé que je travaille à partir. J'ai dans le passé, et je ne ai jamais eu un travail fait, parce que j'étais toujours en attente de quelqu'un pour signer quelque chose hors. C'était plus un problème avec la bureaucratie de la société que j'étais avec que le concept de tout design à l'avant, mais je préfère encore l'approche plus fluide / agile J'ai maintenant.