ERIC Number: EJ1183487
Record Type: Journal
Publication Date: 2018-Jul
Pages: 36
Abstractor: As Provided
ISBN: N/A
ISSN: ISSN-0047-2816
EISSN: N/A
Application Programming Interface Documentation: What Do Software Developers Want?
Meng, Michael; Steinhardt, Stephanie; Schubert, Andreas
Journal of Technical Writing and Communication, v48 n3 p295-330 Jul 2018
The success of an application programming interface (API) crucially depends on how well its documentation meets the information needs of software developers. Previous research suggests that these information needs have not been sufficiently understood. This article presents the results of a series of semistructured interviews and a follow-up questionnaire conducted to explore the learning goals and learning strategies of software developers, the information resources they turn to and the quality criteria they apply to API documentation. Our results show that developers initially try to form a global understanding regarding the overall purpose and main features of an API, but then adopt either a concepts-oriented or a code-oriented learning strategy that API documentation both needs to address. Our results also show that general quality criteria such as completeness and clarity are relevant to API documentation as well. Developing and maintaining API documentation therefore need to involve the expertise of communication professionals.
Descriptors: Programming, Computer Interfaces, Documentation, Computer Software, Audience Analysis, Usability, Information Needs, Semi Structured Interviews, Questionnaires, Information Sources, Computer Oriented Programs, Evaluation Criteria, Expertise, Computer System Design, Learning Strategies, Information Seeking, Qualitative Research, Statistical Analysis, Foreign Countries
SAGE Publications. 2455 Teller Road, Thousand Oaks, CA 91320. Tel: 800-818-7243; Tel: 805-499-9774; Fax: 800-583-2665; e-mail: journals@sagepub.com; Web site: http://sagepub.com
Publication Type: Journal Articles; Reports - Research
Education Level: N/A
Audience: N/A
Language: English
Sponsor: N/A
Authoring Institution: N/A
Identifiers - Location: Germany
Grant or Contract Numbers: N/A