NDLI: How Do Open Source Communities Document Software Architecture: An Exploratory Survey

Content Provider	IEEE Xplore Digital Library
Author	Wei Ding Peng Liang Tang, A. Van Vliet, H. Shahin, M.
Copyright Year	2014
Description	Author affiliation: State Key Lab. of Software Eng., Wuhan Univ., Wuhan, China (Wei Ding; Peng Liang; Shahin, M.) \|\| Fac. of Sci., Eng. & Technol., Swinburne Univ. of Technol., Hawthorn, VIC, Australia (Tang, A.) \|\| Dept. of Comput. Sci., VU Univ. Amsterdam, Amsterdam, Netherlands (Van Vliet, H.)
Abstract	Software architecture (SA) documentation provides a blueprint of a software-intensive system for the communication between stakeholders about the high-level design of the system. In open source software (OSS) development, a lack of SA documentation may hinder the use and further development of OSS, but how much "architecture" documentation is enough and appropriate is largely dependent on the contextual factors of development. In order to understand the state of the practice of SA documentation in OSS projects, we conducted a documentation-based survey to explore how SA is documented in OSS projects. Out of 2,000 OSS projects from four major OSS sources, we found that 108 projects have some SA documentation, which shows that the SA documentation is scarce in OSS development. We analyzed these 108 projects to understand what SA information has been documented and how they have been described. We have found that frequently-documented architectural information is model, system, and mission, natural language is the most frequently-used architectural language for specifying architectural information in OSS SA documents. The results also show that the likelihood that an OSS project will document SA is increased when more developers are involved in the project, and industry and research OSS projects are more likely to create SA documents than freelance projects.
Starting Page	136
Ending Page	145
File Size	259509
Page Count	10
File Format	PDF
e-ISBN	9781479954827
DOI	10.1109/ICECCS.2014.26
Language	English
Publisher	Institute of Electrical and Electronics Engineers, Inc. (IEEE)
Publisher Date	2014-08-04
Publisher Place	China
Access Restriction	Subscribed
Rights Holder	Institute of Electrical and Electronics Engineers, Inc. (IEEE)
Subject Keyword	Documentation Computer architecture Software Unified modeling language Standards Educational institutions Web pages architecture document elements open source software software architecture architecture documentation
Content Type	Text
Resource Type	Article

Sl.	Authority	Responsibilities	Communication Details
1	Ministry of Education (GoI), Department of Higher Education	Sanctioning Authority	https://www.education.gov.in/ict-initiatives
2	Indian Institute of Technology Kharagpur	Host Institute of the Project: The host institute of the project is responsible for providing infrastructure support and hosting the project	https://www.iitkgp.ac.in
3	National Digital Library of India Office, Indian Institute of Technology Kharagpur	The administrative and infrastructural headquarters of the project	Dr. B. Sutradhar bsutra@ndl.gov.in
4	Project PI / Joint PI	Principal Investigator and Joint Principal Investigators of the project	Dr. B. Sutradhar bsutra@ndl.gov.in Prof. Saswat Chakrabarti will be added soon
5	Website/Portal (Helpdesk)	Queries regarding NDLI and its services	support@ndl.gov.in
6	Contents and Copyright Issues	Queries related to content curation and copyright issues	content@ndl.gov.in
7	National Digital Library of India Club (NDLI Club)	Queries related to NDLI Club formation, support, user awareness program, seminar/symposium, collaboration, social media, promotion, and outreach	clubsupport@ndl.gov.in
8	Digital Preservation Centre (DPC)	Assistance with digitizing and archiving copyright-free printed books	dpc@ndl.gov.in
9	IDR Setup or Support	Queries related to establishment and support of Institutional Digital Repository (IDR) and IDR workshops	idr@ndl.gov.in

How do open source communities document software architecture: An exploratory survey (2014)

Web Application fact extractor (WAFE)

Producing Software Architecture Documentation to Suit Your Needs

A ten-year survey of software architecture

An automatic documentation generator based on model-driven techniques

Dealing With Software Concerns In Aspects

Building a UML Profile for COSA Software Architecture

How Developers' Experience and Ability Influence Web Application Comprehension Tasks Supported by UML Stereotypes: A Series of Four Experiments

Introducing tool-supported architecture review into software design education

How Do Open Source Communities Document Software Architecture: An Exploratory Survey

Similar Documents

How do open source communities document software architecture: An exploratory survey (2014)

Web Application fact extractor (WAFE)

Producing Software Architecture Documentation to Suit Your Needs

A ten-year survey of software architecture

An automatic documentation generator based on model-driven techniques

Dealing With Software Concerns In Aspects

Building a UML Profile for COSA Software Architecture

How Developers' Experience and Ability Influence Web Application Comprehension Tasks Supported by UML Stereotypes: A Series of Four Experiments

Introducing tool-supported architecture review into software design education

How Do Open Source Communities Document Software Architecture: An Exploratory Survey