Personalized architectural documentation based on stakeholders' information needs

Autores
Tommasel, Antonela; Nicoletti, Matías Alberto; Diaz Pace, Jorge Andres; Schiaffino, Silvia Noemi; Godoy, Daniela Lis
Año de publicación
2014
Idioma
inglés
Tipo de recurso
artículo
Estado
versión publicada
Descripción
The stakeholders of a software system are, to a greater or lesser extent, concerned about its software architecture, as an essential artifact for capturing the key design decisions of the system. The architecture is normally documented in the Software Architecture Document (SAD), which tends to be a large and complex technical description, and does not always address the information needs of every stakeholder. Individual stakeholders are interested in dierent, sometimes overlapping, subsets of the SAD and they also require varying levels of detail. As a consequence, stakeholders are aected by an information overload problem, which in practice discourages the usage of the architectural knowledge and diminishes its value for the organization. Along this line, this work presents a semi-automated approach to recommend relevant contents of a given SAD to specific stakeholder profiles. Our approach assumes that SADs are hosted in Wikis, which not only favor communication and interactions among stakeholders, but also enable us to apply User Profiling techniques to infer stakeholders´ interests with respect to particular documents. We have built a recommendation tool implementing our approach, which was tested in two experiments with Wiki-based SADs. Although preliminary, the results have shown that the recommendations of the tool help to nd the architectural documents that best match the stakeholders´ interests.
Fil: Tommasel, Antonela. Consejo Nacional de Investigaciones Científicas y Técnicas. Centro Científico Tecnológico Tandil. Instituto Superior de Ingenieria del Software; Argentina
Fil: Nicoletti, Matías Alberto. Consejo Nacional de Investigaciones Científicas y Técnicas. Centro Científico Tecnológico Tandil. Instituto Superior de Ingenieria del Software; Argentina
Fil: Diaz Pace, Jorge Andres. Consejo Nacional de Investigaciones Científicas y Técnicas. Centro Científico Tecnológico Tandil. Instituto Superior de Ingenieria del Software; Argentina
Fil: Schiaffino, Silvia Noemi. Consejo Nacional de Investigaciones Científicas y Técnicas. Centro Científico Tecnológico Tandil. Instituto Superior de Ingenieria del Software; Argentina
Fil: Godoy, Daniela Lis. Consejo Nacional de Investigaciones Científicas y Técnicas. Centro Científico Tecnológico Tandil. Instituto Superior de Ingenieria del Software; Argentina
Materia
Stakeholders
Architecture documentation
Personalization
Wikis
Nivel de accesibilidad
acceso abierto
Condiciones de uso
https://creativecommons.org/licenses/by-nc-sa/2.5/ar/
Repositorio
CONICET Digital (CONICET)
Institución
Consejo Nacional de Investigaciones Científicas y Técnicas
OAI Identificador
oai:ri.conicet.gov.ar:11336/6781

id CONICETDig_1950c5aeb9b219f964e67566f2e42f74
oai_identifier_str oai:ri.conicet.gov.ar:11336/6781
network_acronym_str CONICETDig
repository_id_str 3498
network_name_str CONICET Digital (CONICET)
spelling Personalized architectural documentation based on stakeholders' information needsTommasel, AntonelaNicoletti, Matías AlbertoDiaz Pace, Jorge AndresSchiaffino, Silvia NoemiGodoy, Daniela LisStakeholdersArchitecture documentationPersonalizationWikishttps://purl.org/becyt/ford/1.2https://purl.org/becyt/ford/1The stakeholders of a software system are, to a greater or lesser extent, concerned about its software architecture, as an essential artifact for capturing the key design decisions of the system. The architecture is normally documented in the Software Architecture Document (SAD), which tends to be a large and complex technical description, and does not always address the information needs of every stakeholder. Individual stakeholders are interested in dierent, sometimes overlapping, subsets of the SAD and they also require varying levels of detail. As a consequence, stakeholders are aected by an information overload problem, which in practice discourages the usage of the architectural knowledge and diminishes its value for the organization. Along this line, this work presents a semi-automated approach to recommend relevant contents of a given SAD to specific stakeholder profiles. Our approach assumes that SADs are hosted in Wikis, which not only favor communication and interactions among stakeholders, but also enable us to apply User Profiling techniques to infer stakeholders´ interests with respect to particular documents. We have built a recommendation tool implementing our approach, which was tested in two experiments with Wiki-based SADs. Although preliminary, the results have shown that the recommendations of the tool help to nd the architectural documents that best match the stakeholders´ interests.Fil: Tommasel, Antonela. Consejo Nacional de Investigaciones Científicas y Técnicas. Centro Científico Tecnológico Tandil. Instituto Superior de Ingenieria del Software; ArgentinaFil: Nicoletti, Matías Alberto. Consejo Nacional de Investigaciones Científicas y Técnicas. Centro Científico Tecnológico Tandil. Instituto Superior de Ingenieria del Software; ArgentinaFil: Diaz Pace, Jorge Andres. Consejo Nacional de Investigaciones Científicas y Técnicas. Centro Científico Tecnológico Tandil. Instituto Superior de Ingenieria del Software; ArgentinaFil: Schiaffino, Silvia Noemi. Consejo Nacional de Investigaciones Científicas y Técnicas. Centro Científico Tecnológico Tandil. Instituto Superior de Ingenieria del Software; ArgentinaFil: Godoy, Daniela Lis. Consejo Nacional de Investigaciones Científicas y Técnicas. Centro Científico Tecnológico Tandil. Instituto Superior de Ingenieria del Software; ArgentinaSpringer2014-08info:eu-repo/semantics/articleinfo:eu-repo/semantics/publishedVersionhttp://purl.org/coar/resource_type/c_6501info:ar-repo/semantics/articuloapplication/pdfapplication/pdfapplication/zipapplication/ziphttp://hdl.handle.net/11336/6781Tommasel, Antonela; Nicoletti, Matías Alberto; Diaz Pace, Jorge Andres; Schiaffino, Silvia Noemi; Godoy, Daniela Lis; Personalized architectural documentation based on stakeholders' information needs; Springer; Journal of Software Engineering Research and Development; 2; 9; 8-2014; 1-262195-1721enginfo:eu-repo/semantics/altIdentifier/url/http://jserd.springeropen.com/articles/10.1186/s40411-014-0009-3info:eu-repo/semantics/altIdentifier/url/http://link.springer.com/article/10.1186/s40411-014-0009-3info:eu-repo/semantics/altIdentifier/doi/10.1186/s40411-014-0009-3info:eu-repo/semantics/altIdentifier/doi/info:eu-repo/semantics/openAccesshttps://creativecommons.org/licenses/by-nc-sa/2.5/ar/reponame:CONICET Digital (CONICET)instname:Consejo Nacional de Investigaciones Científicas y Técnicas2025-09-03T09:47:49Zoai:ri.conicet.gov.ar:11336/6781instacron:CONICETInstitucionalhttp://ri.conicet.gov.ar/Organismo científico-tecnológicoNo correspondehttp://ri.conicet.gov.ar/oai/requestdasensio@conicet.gov.ar; lcarlino@conicet.gov.arArgentinaNo correspondeNo correspondeNo correspondeopendoar:34982025-09-03 09:47:49.355CONICET Digital (CONICET) - Consejo Nacional de Investigaciones Científicas y Técnicasfalse
dc.title.none.fl_str_mv Personalized architectural documentation based on stakeholders' information needs
title Personalized architectural documentation based on stakeholders' information needs
spellingShingle Personalized architectural documentation based on stakeholders' information needs
Tommasel, Antonela
Stakeholders
Architecture documentation
Personalization
Wikis
title_short Personalized architectural documentation based on stakeholders' information needs
title_full Personalized architectural documentation based on stakeholders' information needs
title_fullStr Personalized architectural documentation based on stakeholders' information needs
title_full_unstemmed Personalized architectural documentation based on stakeholders' information needs
title_sort Personalized architectural documentation based on stakeholders' information needs
dc.creator.none.fl_str_mv Tommasel, Antonela
Nicoletti, Matías Alberto
Diaz Pace, Jorge Andres
Schiaffino, Silvia Noemi
Godoy, Daniela Lis
author Tommasel, Antonela
author_facet Tommasel, Antonela
Nicoletti, Matías Alberto
Diaz Pace, Jorge Andres
Schiaffino, Silvia Noemi
Godoy, Daniela Lis
author_role author
author2 Nicoletti, Matías Alberto
Diaz Pace, Jorge Andres
Schiaffino, Silvia Noemi
Godoy, Daniela Lis
author2_role author
author
author
author
dc.subject.none.fl_str_mv Stakeholders
Architecture documentation
Personalization
Wikis
topic Stakeholders
Architecture documentation
Personalization
Wikis
purl_subject.fl_str_mv https://purl.org/becyt/ford/1.2
https://purl.org/becyt/ford/1
dc.description.none.fl_txt_mv The stakeholders of a software system are, to a greater or lesser extent, concerned about its software architecture, as an essential artifact for capturing the key design decisions of the system. The architecture is normally documented in the Software Architecture Document (SAD), which tends to be a large and complex technical description, and does not always address the information needs of every stakeholder. Individual stakeholders are interested in dierent, sometimes overlapping, subsets of the SAD and they also require varying levels of detail. As a consequence, stakeholders are aected by an information overload problem, which in practice discourages the usage of the architectural knowledge and diminishes its value for the organization. Along this line, this work presents a semi-automated approach to recommend relevant contents of a given SAD to specific stakeholder profiles. Our approach assumes that SADs are hosted in Wikis, which not only favor communication and interactions among stakeholders, but also enable us to apply User Profiling techniques to infer stakeholders´ interests with respect to particular documents. We have built a recommendation tool implementing our approach, which was tested in two experiments with Wiki-based SADs. Although preliminary, the results have shown that the recommendations of the tool help to nd the architectural documents that best match the stakeholders´ interests.
Fil: Tommasel, Antonela. Consejo Nacional de Investigaciones Científicas y Técnicas. Centro Científico Tecnológico Tandil. Instituto Superior de Ingenieria del Software; Argentina
Fil: Nicoletti, Matías Alberto. Consejo Nacional de Investigaciones Científicas y Técnicas. Centro Científico Tecnológico Tandil. Instituto Superior de Ingenieria del Software; Argentina
Fil: Diaz Pace, Jorge Andres. Consejo Nacional de Investigaciones Científicas y Técnicas. Centro Científico Tecnológico Tandil. Instituto Superior de Ingenieria del Software; Argentina
Fil: Schiaffino, Silvia Noemi. Consejo Nacional de Investigaciones Científicas y Técnicas. Centro Científico Tecnológico Tandil. Instituto Superior de Ingenieria del Software; Argentina
Fil: Godoy, Daniela Lis. Consejo Nacional de Investigaciones Científicas y Técnicas. Centro Científico Tecnológico Tandil. Instituto Superior de Ingenieria del Software; Argentina
description The stakeholders of a software system are, to a greater or lesser extent, concerned about its software architecture, as an essential artifact for capturing the key design decisions of the system. The architecture is normally documented in the Software Architecture Document (SAD), which tends to be a large and complex technical description, and does not always address the information needs of every stakeholder. Individual stakeholders are interested in dierent, sometimes overlapping, subsets of the SAD and they also require varying levels of detail. As a consequence, stakeholders are aected by an information overload problem, which in practice discourages the usage of the architectural knowledge and diminishes its value for the organization. Along this line, this work presents a semi-automated approach to recommend relevant contents of a given SAD to specific stakeholder profiles. Our approach assumes that SADs are hosted in Wikis, which not only favor communication and interactions among stakeholders, but also enable us to apply User Profiling techniques to infer stakeholders´ interests with respect to particular documents. We have built a recommendation tool implementing our approach, which was tested in two experiments with Wiki-based SADs. Although preliminary, the results have shown that the recommendations of the tool help to nd the architectural documents that best match the stakeholders´ interests.
publishDate 2014
dc.date.none.fl_str_mv 2014-08
dc.type.none.fl_str_mv info:eu-repo/semantics/article
info:eu-repo/semantics/publishedVersion
http://purl.org/coar/resource_type/c_6501
info:ar-repo/semantics/articulo
format article
status_str publishedVersion
dc.identifier.none.fl_str_mv http://hdl.handle.net/11336/6781
Tommasel, Antonela; Nicoletti, Matías Alberto; Diaz Pace, Jorge Andres; Schiaffino, Silvia Noemi; Godoy, Daniela Lis; Personalized architectural documentation based on stakeholders' information needs; Springer; Journal of Software Engineering Research and Development; 2; 9; 8-2014; 1-26
2195-1721
url http://hdl.handle.net/11336/6781
identifier_str_mv Tommasel, Antonela; Nicoletti, Matías Alberto; Diaz Pace, Jorge Andres; Schiaffino, Silvia Noemi; Godoy, Daniela Lis; Personalized architectural documentation based on stakeholders' information needs; Springer; Journal of Software Engineering Research and Development; 2; 9; 8-2014; 1-26
2195-1721
dc.language.none.fl_str_mv eng
language eng
dc.relation.none.fl_str_mv info:eu-repo/semantics/altIdentifier/url/http://jserd.springeropen.com/articles/10.1186/s40411-014-0009-3
info:eu-repo/semantics/altIdentifier/url/http://link.springer.com/article/10.1186/s40411-014-0009-3
info:eu-repo/semantics/altIdentifier/doi/10.1186/s40411-014-0009-3
info:eu-repo/semantics/altIdentifier/doi/
dc.rights.none.fl_str_mv info:eu-repo/semantics/openAccess
https://creativecommons.org/licenses/by-nc-sa/2.5/ar/
eu_rights_str_mv openAccess
rights_invalid_str_mv https://creativecommons.org/licenses/by-nc-sa/2.5/ar/
dc.format.none.fl_str_mv application/pdf
application/pdf
application/zip
application/zip
dc.publisher.none.fl_str_mv Springer
publisher.none.fl_str_mv Springer
dc.source.none.fl_str_mv reponame:CONICET Digital (CONICET)
instname:Consejo Nacional de Investigaciones Científicas y Técnicas
reponame_str CONICET Digital (CONICET)
collection CONICET Digital (CONICET)
instname_str Consejo Nacional de Investigaciones Científicas y Técnicas
repository.name.fl_str_mv CONICET Digital (CONICET) - Consejo Nacional de Investigaciones Científicas y Técnicas
repository.mail.fl_str_mv dasensio@conicet.gov.ar; lcarlino@conicet.gov.ar
_version_ 1842268883368542208
score 13.13397