Documentation sur l'architecture

330 mots 2 pages
La documentation sur l'architecture est un type spécial de documents de conception. D'une certaine façon, les documents sur l'architecture sont les troisièmes dérivés du code (les documents de conception étant les seconds dérivés, et documents sur le code étant le premier). Il y a très peu de chose dans les documents sur l'architecture qui soit spécifique au code lui-même. Ces documents ne décrivent pas comment programmer une fonction (routine) particulière, ou même pourquoi cette fonction particulière existe sous cette forme, mais expose les exigences générales qui motivent l'existence d'une telle fonction. Un bon document d'architecture est court sur les détails mais dense sur l'explication. Il peut suggérer des approches pour des conceptions de plus bas niveau, mais laisse les études d'exploration effectives à d'autres documents.

Une autre sorte de documents de conception est le document de comparaison. Cela peut prendre souvent la forme d'un livre blanc. Il se concentre sur un aspect spécifique du système et suggère des approches alternatives. Cela peut se situer au niveau de l'interface utilisateur, du code, de la conception, ou même au niveau de l'architecture. Il soulignera la situation du "SI" (système d'information), décrira une ou plusieurs alternatives en présentant leurs avantages et inconvénients. Une bonne étude comparative est lourde en recherche, exprime ses idées clairement (sans se reposer massivement sur un jargon abscon pour aveugler le lecteur), et surtout est impartiale. Il doit expliquer honnêtement et clairement les coûts de toute solution en regard de ce qu'elle apporte de mieux. L'objectif d'une étude comparative est de discerner la meilleure solution, plutôt que de pousser à un point de vue particulier. Il est parfaitement acceptable de ne pas établir une conclusion, ou de conclure qu'aucune des alternatives n'offre d'avantage substantiel par rapport à la situation actuelle pour justifier un changement. Elle doit être conçue comme une

en relation

  • Commentaire d'arret de cassation 31 mai 1991
    1934 mots | 8 pages
  • Aciers for
    4228 mots | 17 pages
  • Bts 2011
    2088 mots | 9 pages
  • Tn1co
    4872 mots | 20 pages
  • Aide à la prise en compte de contraintes liées aux utilisateurs lors de la conception d’un hypermédia : une étude auprès de concepteurs de sites web
    1104 mots | 5 pages
  • Débats d’idées et validation des élèves en jeu de football : effets de football
    6958 mots | 28 pages
  • Fiche_de_cours 7
    362 mots | 2 pages
  • La peur du déclassement
    289 mots | 2 pages
  • Discours de démission de Mikhaïl Gorbatchev
    1521 mots | 7 pages
  • Document architectural
    309 mots | 2 pages
  • Sujet d'invention
    825 mots | 4 pages
  • Caisse de compensation
    5176 mots | 21 pages
  • Réforme des retraites
    555 mots | 3 pages
  • Dfsdfsdfsdsf
    19835 mots | 80 pages
  • azerty
    892 mots | 4 pages