Software Architecture Documentation: The Road Ahead
Abstract
The basic format in which software requirements and architecture designs are documented is essentially file-based, and it has persisted for decades. Current indexing methods used in file-based documentation are not conducive to retrieving software knowledge. We propose to index software documents with a suitable lightweight ontology to improve the retrieval and traceability of software knowledge. Initial results from a prototype implementation have shown promising prospects.
Integrity signals
Registry
Cites
Statistics
Claims the paper makes
Claims other papers make about this one
Each is checked against this paper’s own text: does it say what the citing paper says it does?
Unpredictable evolution and changes of software requirements complicate architecture design.
“Unpredictable evolution and changes of software requirements complicate architecture design ( group , calendar ).”
From Software Architecture in Practice: Challenges and Opportunities (2023) · cites this paper as [96]
Cited by
Sorted by citations
Knowledge-based approaches in software documentation: A systematic literature review
Ding, W., Liang, P., Tang, A., & van Vliet, H. (2014) · Information and Software Technology · doi:10.1016/j.infsof.2014.01.008 · Cited by 107 · see citing works
Self-citationSoftware Architecture in Practice: Challenges and Opportunities
Wan, Z., Zhang, Y., Xia, X., Jiang, Y., & Lo, D. (2023) · Proceedings of the 31st ACM Joint European Software Engineering Conference and Symposium on the Foundations of Software Engineering · doi:10.1145/3611643.3616367 · Cited by 30 · see citing works
“The unpredictable evolution and changes of requirements sometimes make it infeasible to deliver new features or meet the quality requirements with current architectures, as frequently mentioned in the literature [3, 8, 22, 24, 60, 90, 92].”
Background
- Authors
- Tang, A., Liang, P., & Vliet, H. V.
- Affiliations
- Vrije Universiteit Amsterdam (NL)
- Wuhan University (CN)
- Venue
- 2011 Ninth Working IEEE/IFIP Conference on Software Architecture
- Publisher
- IEEE
- Published
- 2011-06
- Pages
- 252-255
- OpenAlex
- W2118896948
- Cited by
- 46
- References
- 0
- Citations by year
- 2024: 1 · 2023: 2 · 2022: 1 · 2021: 4 · 2020: 3 · 2019: 2 · 2018: 3 · 2017: 4 · 2016: 8 · 2015: 3 · 2014: 5 · 2013: 4 · 2012: 4
- FWCI
- 3.60
- Type
- conference paper
- Language
- en
- Open access
- closed
- Locations
- Working IEEE/IFIP Conference on Software Architecture (WICSA) (publishedVersion)
- VU Research Portal (submittedVersion)
- Swinburne figshare (Swinburne University of Technology) (submittedVersion)
- Data Archiving and Networked Services (DANS) (submittedVersion)
- Topics
- Physical Sciences › Computer Science › Information Systems › Software Engineering Research
- Physical Sciences › Computer Science › Artificial Intelligence › Semantic Web and Ontologies
- Physical Sciences › Computer Science › Artificial Intelligence › Advanced Software Engineering Methodologies
- Keywords
- software architecture documentation, document indexing, lightweight ontologies, traceability, ontology-based information retrieval
About these checks
Registry, retraction, Cites and statistics results are computed, not judged, with one exception: a printed reference that no index lists is read once by a model before it counts as a citation error. Claims are extracted by a model and kept only when their quote appears verbatim in the text; each cited source is then checked, with a model’s help, for whether it says what the claim relies on. Those verdicts can be wrong — read the claim’s quote and the cited source before relying on one.
Statistics and arithmetic are recomputed, not judged.
Confidence bands are shown only for fields calibrated on our annotated test set. None is calibrated yet, so no band is shown.
What counts as a claim ›How we measure confidence ›How we check this ›
Are you an author, or do you see a problem with this page? Request a review
