Enriching software architecture documentation

Anton Jansen, Paris Avgeriou, Jan Salvador van der Ven
<span title="">2009</span> <i title="Elsevier BV"> <a target="_blank" rel="noopener" href="https://fatcat.wiki/container/kqzhqyka2ffqdlbon77fd6trwm" style="color: black;">Journal of Systems and Software</a> </i> &nbsp;
The effective documentation of Architectural Knowledge (AK) is one of the key factors in leveraging the paradigm shift toward sharing and reusing AK. However, current documentation approaches have severe shortcomings in capturing the knowledge of large and complex systems and subsequently facilitating its usage. In this paper, we propose to tackle this problem through the enrichment of traditional architectural documentation with formal AK. We have developed an approach consisting of a method
more &raquo; ... d an accompanying tool suite to support this enrichment. We evaluate our approach through a quasi-controlled experiment with the architecture of a real, large, and complex system. We provide empirical evidence that our approach helps to partially solve the problem and indicate further directions in managing documented AK. Fig. 3. The Knowledge Architect tool suite. A. Jansen et al.
<span class="external-identifiers"> <a target="_blank" rel="external noopener noreferrer" href="https://doi.org/10.1016/j.jss.2009.04.052">doi:10.1016/j.jss.2009.04.052</a> <a target="_blank" rel="external noopener" href="https://fatcat.wiki/release/kgqb5p3y4jezdllwlrmjrvjt5i">fatcat:kgqb5p3y4jezdllwlrmjrvjt5i</a> </span>
<a target="_blank" rel="noopener" href="https://web.archive.org/web/20170809092344/http://www.cs.rug.nl/search/uploads/Publications/jansen2009esa.pdf" title="fulltext PDF download" data-goatcounter-click="serp-fulltext" data-goatcounter-title="serp-fulltext"> <button class="ui simple right pointing dropdown compact black labeled icon button serp-button"> <i class="icon ia-icon"></i> Web Archive [PDF] <div class="menu fulltext-thumbnail"> <img src="https://blobs.fatcat.wiki/thumbnail/pdf/93/e9/93e9aa0c85a57b94c661b6a6b30ccbe7c627354e.180px.jpg" alt="fulltext thumbnail" loading="lazy"> </div> </button> </a> <a target="_blank" rel="external noopener noreferrer" href="https://doi.org/10.1016/j.jss.2009.04.052"> <button class="ui left aligned compact blue labeled icon button serp-button"> <i class="external alternate icon"></i> elsevier.com </button> </a>