A model for documenting architectural decisions

Autores
Roldán, María Luciana; Gonnet, Silvio M.; Leone, Horacio P.
Año de publicación
2013
Idioma
inglés
Tipo de recurso
documento de conferencia
Estado
versión publicada
Descripción
A software architecture is the result of architectural design decisions. Documenting a software architecture should not only describe the final model, but also why the architecture looks as it does. During the software architecture design process, several decisions are made, which need to be captured and documented in a systematic way to prevent knowledge vaporization and high architecture’ costs of change. In this work, a model for capturing, documenting and recovering architectural design processes and their underlying design rationale is proposed. The design process is envisioned under an operational perspective, where design decisions are represented as sequences of operations. Besides, the model is extensible to manage several design products types from different domains and views, including aspects of architectural rationale. Complementary, the proposal provides a semi-automatic mechanism for generating architectural rationale documents based on the use of templates.
Sociedad Argentina de Informática e Investigación Operativa (SADIO)
Materia
Ciencias Informáticas
architecture documentation
design rationale
design decisions
Nivel de accesibilidad
acceso abierto
Condiciones de uso
http://creativecommons.org/licenses/by-nd/3.0/
Repositorio
SEDICI (UNLP)
Institución
Universidad Nacional de La Plata
OAI Identificador
oai:sedici.unlp.edu.ar:10915/76490

id SEDICI_a37cbbe75c7e6a814086a1888cbd14b7
oai_identifier_str oai:sedici.unlp.edu.ar:10915/76490
network_acronym_str SEDICI
repository_id_str 1329
network_name_str SEDICI (UNLP)
spelling A model for documenting architectural decisionsRoldán, María LucianaGonnet, Silvio M.Leone, Horacio P.Ciencias Informáticasarchitecture documentationdesign rationaledesign decisionsA software architecture is the result of architectural design decisions. Documenting a software architecture should not only describe the final model, but also why the architecture looks as it does. During the software architecture design process, several decisions are made, which need to be captured and documented in a systematic way to prevent knowledge vaporization and high architecture’ costs of change. In this work, a model for capturing, documenting and recovering architectural design processes and their underlying design rationale is proposed. The design process is envisioned under an operational perspective, where design decisions are represented as sequences of operations. Besides, the model is extensible to manage several design products types from different domains and views, including aspects of architectural rationale. Complementary, the proposal provides a semi-automatic mechanism for generating architectural rationale documents based on the use of templates.Sociedad Argentina de Informática e Investigación Operativa (SADIO)2013-09info:eu-repo/semantics/conferenceObjectinfo:eu-repo/semantics/publishedVersionObjeto de conferenciahttp://purl.org/coar/resource_type/c_5794info:ar-repo/semantics/documentoDeConferenciaapplication/pdf225-239http://sedici.unlp.edu.ar/handle/10915/76490enginfo:eu-repo/semantics/altIdentifier/url/http://42jaiio.sadio.org.ar/proceedings/simposios/Trabajos/ASSE/17.pdfinfo:eu-repo/semantics/altIdentifier/issn/1850-2792info:eu-repo/semantics/openAccesshttp://creativecommons.org/licenses/by-nd/3.0/Creative Commons Attribution-NoDerivs 3.0 Unported (CC BY-ND 3.0)reponame:SEDICI (UNLP)instname:Universidad Nacional de La Platainstacron:UNLP2025-09-03T10:45:31Zoai:sedici.unlp.edu.ar:10915/76490Institucionalhttp://sedici.unlp.edu.ar/Universidad públicaNo correspondehttp://sedici.unlp.edu.ar/oai/snrdalira@sedici.unlp.edu.arArgentinaNo correspondeNo correspondeNo correspondeopendoar:13292025-09-03 10:45:32.009SEDICI (UNLP) - Universidad Nacional de La Platafalse
dc.title.none.fl_str_mv A model for documenting architectural decisions
title A model for documenting architectural decisions
spellingShingle A model for documenting architectural decisions
Roldán, María Luciana
Ciencias Informáticas
architecture documentation
design rationale
design decisions
title_short A model for documenting architectural decisions
title_full A model for documenting architectural decisions
title_fullStr A model for documenting architectural decisions
title_full_unstemmed A model for documenting architectural decisions
title_sort A model for documenting architectural decisions
dc.creator.none.fl_str_mv Roldán, María Luciana
Gonnet, Silvio M.
Leone, Horacio P.
author Roldán, María Luciana
author_facet Roldán, María Luciana
Gonnet, Silvio M.
Leone, Horacio P.
author_role author
author2 Gonnet, Silvio M.
Leone, Horacio P.
author2_role author
author
dc.subject.none.fl_str_mv Ciencias Informáticas
architecture documentation
design rationale
design decisions
topic Ciencias Informáticas
architecture documentation
design rationale
design decisions
dc.description.none.fl_txt_mv A software architecture is the result of architectural design decisions. Documenting a software architecture should not only describe the final model, but also why the architecture looks as it does. During the software architecture design process, several decisions are made, which need to be captured and documented in a systematic way to prevent knowledge vaporization and high architecture’ costs of change. In this work, a model for capturing, documenting and recovering architectural design processes and their underlying design rationale is proposed. The design process is envisioned under an operational perspective, where design decisions are represented as sequences of operations. Besides, the model is extensible to manage several design products types from different domains and views, including aspects of architectural rationale. Complementary, the proposal provides a semi-automatic mechanism for generating architectural rationale documents based on the use of templates.
Sociedad Argentina de Informática e Investigación Operativa (SADIO)
description A software architecture is the result of architectural design decisions. Documenting a software architecture should not only describe the final model, but also why the architecture looks as it does. During the software architecture design process, several decisions are made, which need to be captured and documented in a systematic way to prevent knowledge vaporization and high architecture’ costs of change. In this work, a model for capturing, documenting and recovering architectural design processes and their underlying design rationale is proposed. The design process is envisioned under an operational perspective, where design decisions are represented as sequences of operations. Besides, the model is extensible to manage several design products types from different domains and views, including aspects of architectural rationale. Complementary, the proposal provides a semi-automatic mechanism for generating architectural rationale documents based on the use of templates.
publishDate 2013
dc.date.none.fl_str_mv 2013-09
dc.type.none.fl_str_mv info:eu-repo/semantics/conferenceObject
info:eu-repo/semantics/publishedVersion
Objeto de conferencia
http://purl.org/coar/resource_type/c_5794
info:ar-repo/semantics/documentoDeConferencia
format conferenceObject
status_str publishedVersion
dc.identifier.none.fl_str_mv http://sedici.unlp.edu.ar/handle/10915/76490
url http://sedici.unlp.edu.ar/handle/10915/76490
dc.language.none.fl_str_mv eng
language eng
dc.relation.none.fl_str_mv info:eu-repo/semantics/altIdentifier/url/http://42jaiio.sadio.org.ar/proceedings/simposios/Trabajos/ASSE/17.pdf
info:eu-repo/semantics/altIdentifier/issn/1850-2792
dc.rights.none.fl_str_mv info:eu-repo/semantics/openAccess
http://creativecommons.org/licenses/by-nd/3.0/
Creative Commons Attribution-NoDerivs 3.0 Unported (CC BY-ND 3.0)
eu_rights_str_mv openAccess
rights_invalid_str_mv http://creativecommons.org/licenses/by-nd/3.0/
Creative Commons Attribution-NoDerivs 3.0 Unported (CC BY-ND 3.0)
dc.format.none.fl_str_mv application/pdf
225-239
dc.source.none.fl_str_mv reponame:SEDICI (UNLP)
instname:Universidad Nacional de La Plata
instacron:UNLP
reponame_str SEDICI (UNLP)
collection SEDICI (UNLP)
instname_str Universidad Nacional de La Plata
instacron_str UNLP
institution UNLP
repository.name.fl_str_mv SEDICI (UNLP) - Universidad Nacional de La Plata
repository.mail.fl_str_mv alira@sedici.unlp.edu.ar
_version_ 1842260328626257920
score 13.13397