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
- Institución
- Consejo Nacional de Investigaciones Científicas y Técnicas
- OAI Identificador
- oai:ri.conicet.gov.ar:11336/6781
Ver los metadatos del registro completo
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 |