Personalized architectural documentation based on stakeholders’ information needs
Tóm tắt
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 different, sometimes overlapping, subsets of the SAD and they also require varying levels of detail. As a consequence, stakeholders are affected by an information overload problem, which in practice discourages the usage of the architectural knowledge and diminishes its value for the organization. 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. The experiments aimed at assessing the performance reached by our tool when inferring stakeholders’ interests. To this end, precision and recall metrics were used. Although preliminary, the results have shown that the recommendations of the tool help to find the architectural documents that best match the stakeholders’ interests.
Tài liệu tham khảo
Al halabi WS, Kubat M, Tapia M: Time spent on a web page is sufficient to infer a user’s interest. In Proceedings of the IASTED European Conference: Internet and Multimedia Systems and Applications (IMSA IASTED). ACTA Press, Anaheim, CA, USA; 2007:41–46.
Baeza-Yates R, Ribeiro-Neto B: Modern Information Retrieval: The Concepts and Technology Behind Search. Addison-Wesley Professional, Boston, USA; 2011.
Bass L, Clements P, Kazman R: Software Architecture in Practice. Addison-Wesley Professional, Boston, USA; 2012.
Castro-Herrera, C, Cleland-Huang J, Mobasher B (2009) Enhancing stakeholder profiles to improve recommendations in online requirements elicitation. In: 17th IEEE International Requirements Engineering Conference (RE), 37–46, Atlanta, USA.
Claypool M, Le P, Wased M, Brown D: Implicit interest indicators. In Proceedings of the 6th International Conference on Intelligent User Interfaces (ICIUI). IUI ’01. ACM, New York, NY, USA; 2001:33–40. 10.1145/359784.359836
Clements P, Bachmann F, Bass L, Garlan D, Ivers J, Little R, Nord R, Stafford J: A practical method for documenting software architectures. In Proceedings of the International Conference on Software Engineering (ICSE). Portland, USA; 2003.
Clements P, Bachmann F, Bass L, Garlan D, Ivers J, Little R, Merson P, Nord R, Stafford J: Documenting Software Architectures: Views and Beyond (2nd Edition). Addison-Wesley Professional, Boston, USA; 2010.
de Boer RC, van Vliet H: Architectural knowledge discovery with latent semantic analysis: Constructing a reading guide for software product audits. J Syst Softw 2008,81(9):1456–1469. 10.1016/j.jss.2007.12.815
de Graaf KA, Tang A, Liang P, van Vliet H: Ontology-based software architecture documentation. In Proceedings of Joint Working Conference on Software Architecture & 6th European Conference on Software Architecture (WICSA/ECSA). WICSA 2012. IEEE Computer Society, Helsinki, Finland; 2012:315–319.
Deza E, Deza M: Dictionary of Distances. North-Holland Elsevier, Amsterdam, Netherlands; 2006.
Deza MM, Deza E: Encyclopedia of Distances. Springer, New York, USA; 2009.
Dice LR: Measures of the amount of ecologic association between species. Ecology 1945,26(3):297–302. 10.2307/1932409
Diaz-Pace JA, Nicoletti M, Schiaffino S, Villavicencio C, Sanchez L: A stakeholder-centric optimization strategy for architectural documentation. In Model and Data Engineering. Edited by: Cuzzocrea A, Maabout S. Lecture Notes in Computer Science, Springer, New York, USA; 2013:104–117. 10.1007/978-3-642-41366-7_9
Farenhorst, R, van Vliet H (2008) Experiences with a wiki to support architectural knowledge sharing. In: Proceedings of the 3rd Workshop on Wikis for Software Engineering (Wiki4SE), Porto, Portugal.
Goossen F, IJntema W, Frasincar F, Hogenboom F, Kaymak U: News personalization using the cf-idf semantic recommender. In Proceedings of the International Conference on Web Intelligence, Mining and Semantics (ICWIMS). WIMS ’11. ACM, New York, NY, USA; 2011:10–11012.
Huang A: Similarity measures for text document clustering. In Proceedings of the 6th New Zealand Computer Science Research Student Conference (NZCSRSC2008). Christchurch, New Zealand; 2008:49–56.
ISO/IEC/IEEE (2011) ISO/IEC/IEEE 42010: Systems and Software Engineering - Architecture Description. ISO/IEC/IEEE. International Organization for Standardization, number: 42010. ., [http://www.iso-architecture.org/]
Koning H, Vliet HV: Real-life it architecture design reports and their relation to ieee std 1471 stakeholders and concerns. Automated Softw Eng 2006, 13: 201–223. 10.1007/s10515-006-7736-6
Jansen A, Avgeriou P, van der Ven JS: Enriching software architecture documentation. J Syst Softw 2009,82(8):1232–1248. SI: Architectural Decisions and Rationale SI: Architectural Decisions and Rationale 10.1016/j.jss.2009.04.052
Liu B: Web Data Mining: Exploring Hyperlinks, Contents and Usage Data. Data-Centric Systems and Applications. Springer, New York, USA; 2011.
Mitchell T: Machine Learning, 1st edn. McGraw-Hill Science/Engineering/Math, New York, USA; 1997.
Mitchell RK, Agle BR, Wood DJ: Toward a theory of stakeholder identification and salience: Defining the principle of who and what really counts. Acad Manag Rev 1997, 22: 853.
Nicoletti M, Diaz-Pace JA, Schiaffino S: Towards software architecture documents matching stakeholders interests. In Advances in New Technologies, Interactive Interfaces and Communicability. Lecture Notes in Computer Science. Edited by: Cipolla-Ficarra F, Veltman K, Verber D, Cipolla-Ficarra M, Kammuller F. Springer, New York, USA; 2012:176–185. 10.1007/978-3-642-34010-9_17
Nicoletti M, Schiaffino S, Godoy D: Mining interests for user profiling in electronic conversations. Expert Syst Appl 2013a,40(2):638–645. 10.1016/j.eswa.2012.07.075
Nicoletti M, Diaz-Pace JA, Schiaffino S: Discovering stakeholders’ interests in wiki-based architectural documentation. In Proceedings of CIbSE 2013 (former IDEAS). XVI Ibero-American Conference on Software Engineering, Montevideo, Uruguay. Edited by: Diego Vallespir MdOB. Universidad ORT Uruguay, Universidad de la Republica, Antel; 2013b:5–18.
Nord RL, Clements PC, Emery DE, Hilliard R: Reviewing architecture documents using question sets. In Proceedings of Joint Working IEEE/IFIP Conference on Software Architecture & European Conference on Software Architecture (WICSA/ECSA). IEEE, Cambridge, UK; 2009:325–328.
Rajaraman A, Ullman JD: Mining of Massive Datasets. Cambridge University Press, Cambridge; 2012.
Schiaffino S, Amandi A: Intelligent user profiling. In Artificial Intelligence: An International Perspective. Lecture Notes in Computer Science. Edited by: Bramer M. Springer, New York, USA; 2009:193–216.
Su MT: Capturing exploration to improve software architecture documentation. In Proceedings of the 4th European Conference on Software Architecture (ECSA). ECSA ’10. ACM, New York, NY, USA; 2010:17–21. 10.1145/1842752.1842758
Su, MT, Hosking J, Grundy J (2011) Capturing architecture documentation navigation trails for content chunking and sharing. In: 2011 9th Working IEEE/IFIP Conference on Software Architecture (WICSA), 256–259, Boulder, USA.
Sørensen T: A method of establishing groups of equal amplitude in plant sociology based on similarity of species and its application to analyses of the vegetation on danish commons. Biol Skr 1948, 5: 1–34.
Unphon H, Dittrich Y: Software architecture awareness in long-term software product evolution. J Syst Softw 2010,83(11):2211–2226. 10.1016/j.jss.2010.06.043
Wohlin C, Runeson P, Höst M, Ohlsson M, Regnell B: Experimentation in Software Engineering. Springer, New York, USA; 2012.