An Empirical Study of API Usability


Modern software development extensively involves reusing library components accessed through their Application Programming Interfaces (APIs). Usability is therefore a fundamental goal of API design, but rigorous empirical studies of API usability are still relatively uncommon. In this paper, we present the design of an API usability study which combines interview questions based on the cognitive dimensions framework, with systematic observations of programmer behavior while solving programming tasks based on ``tokens''. We also discuss the implementation of the study to assess the usability of a persistence library API (offering functionalities such as storing objects into relational databases). The study involved 25 programmers (including students, researchers, and professionals), and provided additional evidence to some critical features evidenced by related studies, such as the difficulty of finding good names for API features and of discovering relations between API types. It also discovered new issues relevant to API design, such as the impact of flexibility, and confirmed the crucial importance of accurate documentation for usability.

DOI: 10.1109/ESEM.2013.14

Extracted Key Phrases

2 Figures and Tables

Showing 1-10 of 37 references

Spring framework data access data-access, last visited: 15.03

  • 2013

API Design for C++

  • M Reddy
  • 2011

Improving software API usability through text analysis: A case study

  • R B Watson
  • 2009

Framework Design Guidelines: Conventions , Idioms, and Patterns for Reusable

  • K Cwalina, B Abrams
  • 2008
Showing 1-10 of 10 extracted citations